マークダウン記法は奥深く、楽しい — テキストだけで「伝わるドキュメント」を作る技術 - Qiita

結局Mermaidとか凝りすぎて「テキストだけでシンプルに」という初心を忘れていくのが様式美。エンジニアのドキュメント作成時間の半分はこれに溶けてる説

marmeidで雑に絵も描けてここ10年くらいは必要充分だとは思ってる

手段が目的になるやつ。

gitで管理しやすい & AIでの利用に向いてるのは利点だけど、直感的に図形描画できないのはつらい。

便利

半分はMarkdownでなくMarmaidの話になっている。Markdownは見出しと本文と箇条書きの使い方が基本であり重要である。

3以降は通常のmarkdownでは使えないので、記事の大半が関係ない話になってしまっている。markdownはもう少し各所の独自ルールを取り込んで拡張規定をつくってくれないものか。

メモ

やっぱり表かぁ。神エクセルを彷彿とさせる。時代の呪文だ。