マークダウン記法チートシート:仕組みからわかる書き方

マークダウンは少数の記号だけでテキストを整形する記法です。それぞれの記号が何をするのか、なぜこの形式が広まったのかを見てみましょう。

見出しは # の数で決まる

「# 」から「###### 」までがh1〜h6の見出しに対応し、#の後には半角スペースが必要。

強調は * または _ で囲む

*斜体*・_斜体_で斜体、**太字**・__太字__で太字、***太字斜体***で両方の強調になる。

リストは - や 1. で作る

「-」や「*」で箇条書き、「1.」のような数字とピリオドで番号付きリストになり、インデントを加えることで入れ子のリストも作れる。

コードはバッククォートで囲む

1つのバッククォートで囲むとインラインコード、3つ重ねた```で複数行のコードブロックになり、言語名を添えるとシンタックスハイライトが有効になることが多い。

引用と区切り線

行頭に「>」を置くと引用文、「---」だけの行を入れると水平の区切り線になる。

なぜマークダウンはここまで普及したのか

HTMLタグと違い、レンダリングされていない状態でもプレーンテキストとしてそのまま読みやすいように設計されており、特別なエディタなしでも書けるほど軽量です。この特性がGitHubやドキュメントツール、チャットアプリ、ノートアプリなど幅広いサービスで採用される決め手になりました。

マークダウンは完全に統一された規格ではない

基本の記法自体は最小限ですが、多くのプラットフォームは表組みやチェックボックス付きタスクリスト、取り消し線、脚注などの拡張機能(GitHub Flavored Markdownなど)を独自に追加しています。あるプラットフォーム用に書いた文書が、別のシンプルなパーサーでは一部正しく表示されないことがあるのはこのためです。

よくある質問

マークダウンに対応しているアプリなら、どこでも全く同じように表示されますか?

基本的な記法はほぼどこでも共通して動作しますが、表組みや脚注などの拡張機能は、そのプラットフォームが採用している「フレーバー」やパーサーに依存するため、必ずしも同じように表示されるとは限りません。

マークダウンの中にHTMLタグを混ぜて書くことはできますか?

多くのマークダウン実装では、生のHTMLタグをそのまま通してレンダリングする仕組みが用意されており、改行の<br>のようにマークダウンだけでは表現しにくい部分に使われます。ただし全てのプラットフォームで同じように動作するとは限らず、セキュリティ上の理由で生のHTMLを無効にしている場合もあります。