GitHub の Markdown が Mermaid 形式をサポートするようなのでメモ。
Mermaid は以前、取り上げたPlantUML と同様にフローチャートや UML の画像を生成して埋め込むための DSL です。これでイチイチ画像を生成して Markdown に貼り込む必要がなくなるのでメンテナンスも楽になりますね。
Include diagrams in your Markdown files with Mermaid | The GitHub Blog
Mermaid is a JavaScript based diagramming and charting tool that takes Markdown-inspired text definitions and creates diagrams dynamically in the browser.
Markdown のリポジトリと Live エディタは以下にあります。
Markdown の WYSIWYG に対応しているエディタを探していたらTypora というのが良さそうだったので使い始めてみました。
Windows だけでなくMac や Linux にも対応していて、便利も豊富*1でシンプルな操作感が気に入っています。
また、フローチャートやシーケンス図も書けます。
Typora — a markdown editor, markdown reader.
Typora gives you a seamless experience as both a reader and a writer. It removes the preview window, mode switcher, syntax symbols of markdown source code, and all other unnecessary distractions. Instead, it provides a real live preview feature to help you concentrate on the content itself.
Teams ではチャネルへの書き込みやチャットなどで Slack とほぼ同様のマークダウンの書式が使えます。
ただ、イマイチ何が使えて、使えないのかよく分かっていなかったので仕様をメモ。
例えばインラインコードブロックのように、書式パレットから呼び出せないものもありますね。
Markdown っぽい表記をすると、それに対応する ER 図のようなものが書ける Web ツール 「MarkDownDiagram」が面白そうだったのでメモ。確かにこれならばプログラム等で構造を解析するのは楽なので、使いようによってはかなり面白い使い方ができそうですね。
HTML 文章からプレーンなテキストを取り出すのに何か良い方法はないかと思っていろいろ探してみたら、Python で書かれたhtml2text が良さそうだったのでメモ。
html2text is a Python script that converts a page of HTML into clean, easy-to-read plain ASCII text. Better yet, that ASCII also happens to be valid Markdown (a text-to-HTML format).
使い方はこんな感じ。入力の文字コードは UTF-8 を期待しているようなので、nkf を噛ませています。
HTMLをテキストに変換すると壊れた文字が入ったりとかいろいろと難しいのですが、試した限りだとこれが一番良好な結果を返しました。