Markdown とは？

ただのテキストファイルだから、普通のエディタで書けるし、Gitで変更箇所の差分も見やすいんだ。それにGitHubでは、リポジトリにREADME.mdを置くと訪れた人に自動で表示されるよ。ドキュメントを書く場面でよく使われているね。

行頭の # で見出し（## で一段下の見出し）、行頭の - で箇条書き、**太字**、*斜体*、[リンクテキスト](URL) でリンク、 で画像だよ。コードはバッククォートで囲むんだ。これだけ覚えれば、簡単な文書は書けるよ。

元のMarkdownの説明は書き方のルールをあいまいさなく定めていなかったから、変換ツールごとに解釈が分かれたんだ。そこでCommonMarkという厳密な仕様が作られたよ。GitHubで使うGFMはCommonMarkに表やタスクリスト、取り消し線などの拡張を加えたものなんだ。

変わることがあるよ。例えば表の書き方はGFMの拡張で、元のMarkdownやCommonMarkの標準には入っていないんだ。Markdownは書き間違えてもエラーにならず、そのまま違う表示になることがあるから、使うサービスの仕様を確認してプレビューで見ておくと安心だね。

作者のGruber氏自身が「MarkdownはHTMLの代わりではない」と書いているよ。Markdownはよく使う書式を手軽に書くためのもので、記法にない表現はHTMLを直接書くんだ。ただGitHubのように、安全のため一部のHTMLを使えなくしているサービスもあるよ。