マークダウンでのプログラミングをやめよう
マークダウンは文書作成には適しているが、プログラミングの手段として使うべきではない。コードとドキュメントを混在させるアプローチは、保守性や可読性を損ない、開発効率を低下させる。本記事では、マークダウンをプログラミングに使うことの問題点と、より適切な代替手法を解説する。
背景メモ
- この記事は、非エンジニア向けに「誰でも簡単にプログラミングできる」と謳うMarkdownベースのツール（例：Observable Framework、Mintlify、V0 by Vercelなど）を批判している。著者は、そうしたツールが「Markdownさえ書ければアプリが作れる」という幻想を売りにしているが、実際には複雑な依存関係やデバッグ不能な状態を生み出し、むしろ生産性を損なうと論じる。
- Markdownは本来、プレーンテキストで書かれた文書をシンプルに整形するための軽量マークアップ言語。それをプログラミングの主要インターフェースに据える動きが、ここ数年で一部のスタートアップやツールベンダーによって進んでいる。
- 著者は、LLM（大規模言語モデル）がMarkdownとコードブロックを頻繁に出力する習慣を持っていることや、Notion／Coda／Observableといった文書中心のツールが「コードを文書に埋め込む」アプローチを取っていることを背景として挙げている。
- ただし実際のソフトウェア開発では、純粋なプログラミング言語による抽象化、バージョン管理、型安全性、テスト可能性といった仕組みが不可欠であり、Markdownのリッチテキスト表現にそれらを無理やり詰め込むのは誤った抽象化だと指摘。特に、暗黙的なインポートや副作用が発生しやすいObservable Frameworkのノートブック構造を具体例として問題視している。
- この議論は、ローコード／ノーコード運動やAIによるコード生成の台頭の中で、「本当にプログラミングを民主化しているのは何か」という広い論争の一部でもある。