Markdown とは何か、どこから来たのか、何のためのものか
**手短に言えば:**Markdown は、プログラムなしで人が読める記号を使って、プレーンテキストのファイルに書式つきの文章を書くための方法です。# で始まる行は見出し、**このように** 書けば太字、- で始まる行はリストの項目になります。変換プログラムがそれを HTML にしますが、人間はどちらの状態でも問題なく読めます。この二重の性格、つまりテキストとして読めて、同時に書類として組版できるという点がすべての発想の中心であり、置き換えようとして現れたより高機能な形式のどれよりも長く生き残った理由でもあります。
どこから来たのか
Markdown は 2004 年 3 月に John Gruber が公開したもので、Aaron Swartz と一緒に書き上げました。実装は Markdown.pl という約 1,400 行の Perl スクリプトで、目的もはっきり述べられていました。ウェブ向けに文章を書く人たちは HTML タグを手で打つことに疲れていて、しかもメールが、文章に略式の印を付ける書き方をすでに全員に教えていました。
この最後の点が重要です。Markdown は記号を発明したわけではありません。プレーンテキストのメールで人々がすでに使っていた慣習を集めたのです。
- 強調したい語をアスタリスクで囲む書き方。Usenet とメールが 20 年続けてきたもの
- 返信を引用するときに行頭に
>を付ける書き方。どのメールソフトもやっていたもの - 見出しを
===や---で下線のように飾る書き方。Ian Feldman が 1992 年に作った形式 Setext に由来するもの - 見出しの前に
#を置く書き方。Aaron Swartz が 2002 年に書いた atx に由来するもの
Gruber が果たした仕事は、その取捨選択と、その背後にある原則でした。Markdown の文書は、タグで覆われた文書ではなく、プレーンテキストの文書のように読めるべきである。Markdown の存在を知らない読者にとって、記法のどれもマークアップに見えてはいけない、というものです。
名前は markup をもじった冗談で、当初のライセンスは誰でも再実装できるほど緩やかなものでした。そして実際に、誰もが再実装しました。
なぜ広まったのか
Markdown には委員会も企業も標準規格もありませんでしたが、それでも結局どこにでもあるものになりました。3 つの性質がそうさせました。
プレーンテキストなので、既存のあらゆるツールがそのまま使えます。 バージョン管理は行単位で差分を取り、段落の中で何が変わったかを示せます。ワープロのファイルで同じことを試してみてください。検索でも見つかります。スクリプトで生成もできます。メールで送られ、チャットに貼られ、またコピーされても壊れません。40 年後でも開けます。
学習の費用は 5 分ほどです。 記号を 3 つ知っていれば仕事になりますし、残りは必要になったときに覚えればよいのです。ツールバーの奥に隠されているものはありません。
うまく劣化します。 Markdown を表示できない環境の読者にはアスタリスクやハッシュが見えますが、それでも文章は正しい順序で読めて、構造も見えています。バイナリ形式にはこれができません。
早い時期に採用したプラットフォームが、それを既定のものにしました。Stack Overflow は 2008 年に Markdown エディタとともに登場しました。GitHub はプロジェクトのページで README.md を表示し、そこから「README は Markdown で書く」が業界全体の慣習になりました。同じ年に公開された Jekyll は Markdown ファイルの入ったフォルダをウェブサイトに変え、GitHub Pages がそれを無料で配信しました。
2016 年には、この形式は IANA に text/markdown メディアタイプとして RFC 7763 で登録されるほど一般的になっていました。
方言と、それがいくつもある理由
Gruber による当初の説明は、いくつもの場合を未定義のまま残していました。リストが途中で中断されたらどうなるのか、強調が語の内側でどう入れ子になるのか、はぐれた括弧は何を意味するのか。実装ごとにそれらの解決が違ったので、同じファイルがツールによって違って表示されました。
2014 年、Pandoc の作者である John MacFarlane を含むグループが、テストスイートを備えた厳密な仕様を書きました。それは「Standard Markdown」として公開され、Gruber がその名前に異を唱えたため、CommonMark に改名されました。今日のほとんどのレンダラーが従っているのは、この仕様です。
| 方言 | 加えるもの | 出会う場所 |
|---|---|---|
| CommonMark | 厳密な土台。曖昧さのない規則とテストスイート | ほとんどのライブラリとエディタ |
| GitHub Flavored Markdown | 表、タスクリスト、打ち消し線、自動リンク、脚注、アラート | GitHub、GitLab、ほとんどの README |
| MultiMarkdown | 引用文献、相互参照、メタデータ、より良い表 | 学術的な文章や長文 |
| Pandoc Markdown | 上記すべてに加えて数式、図版、PDF・Word・LaTeX への出力 | 論文、書籍、学位論文 |
| MDX | 本文に埋め込む JSX で書かれたコンポーネント | React で作られたドキュメントサイト |
今日 Markdown と言うとき、ほとんどの人が指しているのは GFM です。CommonMark に、GitHub が 2017 年に定めた拡張を加えたものです。PreviewMD は GFM を表示し、数式は KaTeX、図は Mermaid で描きます。
何に使われているのか
ドキュメントと README。 開発者が読むものはほぼこれが既定です。プロジェクトの readme、変更履歴、設計のメモ、運用手順書。ドキュメントサイト、たとえば MkDocs、Docusaurus、Hugo、Astro は、たいてい Markdown の入ったフォルダの上にテーマをかぶせたものです。
ノート。 Obsidian、Bear、iA Writer、Logseq とそのほか多くのアプリが、ノートを Markdown ファイルとして保存します。つまりご自身のノートは閉じ込められません。どのエディタでも読めて、どのツールでもバックアップできて、書き出しの手順を踏まずに別のアプリへ移れます。
ウェブ向けの執筆。 静的サイト、ニュースレター、ブログ。マークアップではなく文章そのものを書きたい人のためのものです。いまお読みのこの記事も Markdown ファイルで、このページの上にある切り替えがそれを見せてくれます。
書式を受け付けるテキスト欄のあるところすべて。 課題管理、プルリクエスト、チャットアプリ、フォーラム、ウィキは Markdown かそれに近いものを使っています。
機械との会話。 言語モデルは既定で Markdown を出力します。そのことが、いつの間にか Markdown を人と AI ツールのあいだの共通語にしました。アシスタントの答えに見える見出しやリスト、コードの囲みは、表示された Markdown です。
向いていないこと
Markdown は構造の形式であって、レイアウトの形式ではありません。何かがページのどこに置かれるか、段の幅がどれだけか、どのフォントを使うかを指定する手段がありません。これは意図的なものです。そうした判断は、その文書を表示する側に属するからです。
ですから、ページの形そのものが目的になる場合には向きません。チラシ、申込用紙、雑誌の見開きなどです。セルを結合した複雑な表は扱いにくく、ふつうは HTML になってしまいます。引用文献と相互参照を伴う学術的な文章にも、素の Markdown だけでは足りません。Pandoc や MultiMarkdown の拡張があるのは、そのためです。
よくある不満、つまり「自分のファイルが別のアプリでは違って見える」は、ほぼ必ず方言の違いです。CommonMark に GFM を加えた範囲で書くのが最も安全です。それが最も多くのツールが一致している範囲だからです。
Mac での Markdown
macOS は .md を最初から表示してはくれません。スペースキーではプレーンテキストが出てきますし、ノートの入ったフォルダは同じ白紙のアイコンが積み重なったように見えます。
PreviewMD はまさにその部分を直します。クイックルックでのプレビュー、書類のサムネイル、そして整形されたページをそのソースと並べて見せるウィンドウです。GitHub Flavored Markdown を表示し、KaTeX の数式と Mermaid の図を同梱しているので、書類の表示中に何も取得しません。
チートシートにはすべての記号とその結果が並んでいますし、Mac で .md ファイルを開く方法では実際の手順を扱っています。