マークダウン記法の基本ガイド
**マークダウン記法の基本セットは、John Gruber氏が2004年のオリジナル設計ドキュメントで定義した11個の書式要素で構成され、2026年現在もほぼすべてのMarkdownアプリケーションがその全要素をサポートしています。**11要素とは、見出し、段落、改行、強調、引用、リスト、コード、水平線、リンク、画像、文字のエスケープです。どの要素もキーボード上にある記号だけで書け、それぞれが特定のHTMLタグに変換されます。プロセッサー間には細かな差異があるため、本ガイドではどの環境でも同じように表示される書き方を明示します。以下の例はすべて、ライブプレビュー付きのMarkdownエディタにそのまま貼り付けられ、入力と同時にレンダリング結果を確認できます。
見出し
見出しは1個から6個のシャープ記号(#)とスペースで始まり、記号の数がH1からH6までのレベルを決めます。
# Heading level 1
## Heading level 2
### Heading level 3
#### Heading level 4
##### Heading level 5
###### Heading level 6
各行は対応するHTMLタグに変換されるため、# Page Title はh1要素として、###### Fine Print はh6要素としてレンダリングされます。マークダウンの見出しには、上位2レベルに限り別の書き方もあります。テキストの下の行にイコール記号を並べるとH1、ハイフンを並べるとH2になります。#を使う形式はATXスタイル、下線を使う形式はSetextスタイルと呼ばれます。
Heading level 1
===============
Heading level 2
---------------
ベストプラクティス:すべての見出しの前後に空行を入れ、シャープ記号とテキストの間にスペースを1個置くと、どのアプリケーションでも見出しが正しくレンダリングされます。
段落
段落は、上下を空行で挟んだ1行以上の連続したテキストで、マーカーは一切必要ありません。
The first paragraph ends here.
A blank line above this sentence starts a second paragraph.
レンダラーは各ブロックをpタグで囲むため、上の2つのブロックは2つの別々のHTML段落になります。ブロック内の単独の改行は連続したテキストにまとめられるので、ソースを80文字で折り返しても出力は途切れない1つの段落のままです。
ベストプラクティス:段落は必ず左端に揃えて書きます。行頭に4個以上のスペースがあると、段落はコードブロックに変わってしまうためです。
改行
段落内で改行するには、行末に2個以上の半角スペースを付けるか、HTMLタグの <br> を使います。
This line ends with 2 trailing spaces.
This line appears directly below it.
This line ends with a br tag.<br>
This line also sits inside the same paragraph.
どちらの方法もbr要素としてレンダリングされ、2行目は段落の間隔を空けずに1行目の直下に表示されます。何も付けずに改行しただけでは、2つの行は1つにつながります。CommonMarkは行末のバックスラッシュも改行として扱いますが、古いプロセッサーは無視するため、どこでも通用する方法は行末スペースと <br> タグの2つです。
ベストプラクティス:コピー&ペーストやコードレビューを経ても消えない改行が必要な場合は <br> タグを選びます。行末スペースはほとんどのエディタで見えないためです。
強調(太字・斜体)
マークダウンで太字にするにはアスタリスク2個で囲み、斜体は1個、太字斜体は3個で囲みます。単語全体を囲む場合はアンダースコアも同等に使えます。
This word is **bold** and so is this __word__.
This word is *italic* and so is this _word_.
This phrase is ***bold and italic***.
レンダラーはマーカーをstrongタグとemタグに変換します。**bold** は <strong>bold</strong> に、*italic* は <em>italic</em> になり、3個のマーカーは一方のタグをもう一方の内側にネストします。強調は単語の途中でも機能し、un*believ*able は中央の6文字だけを斜体にします。
ベストプラクティス:単語の途中を強調する場合はアンダースコアではなくアスタリスクを使います。単語内のアスタリスクはすべての主要プロセッサーが同じように処理しますが、単語内のアンダースコアは挙動が分かれるためです。
引用
引用は行頭の大なり記号(>)で始まり、引用する各行にそれぞれマーカーを付けます。
> A single-paragraph quote needs 1 marker per line.
>
> A marked blank line continues the quote into a second paragraph.
>
>> Two markers push this paragraph 1 level deeper as a nested quote.
出力はblockquote要素になり、マーカーを2個重ねると最初の引用の中に2つ目の引用が1レベル深くネストされます。引用の中では他のマークダウンも使えます。各行が > マーカーで始まっていれば、見出し、リスト、太字は引用内でも通常どおりレンダリングされるため、構造を持つ引用メールや出典付きの文章に適しています。
ベストプラクティス:すべての引用の前後に空行を置くと、どのプロセッサーでも引用の開始位置と終了位置が正確に検出されます。
リスト(箇条書き)
番号付きリストは各項目の前に数字とピリオドを置き、箇条書き(番号なしリスト)は各項目の前にハイフン、アスタリスク、またはプラス記号を置きます。
1. First step
2. Second step
3. Third step
1. Indented sub-step
- Bullet item
- Bullet item
- Nested bullet
番号付きリストはol要素としてレンダリングされ、最初に入力した数字から数え始めるため、1、8、3と書いたリストも出力は1、2、3になります。マークダウンの箇条書きは、3種類の記号のいずれを使ってもul要素としてレンダリングされます。半角スペース4個またはタブ1個のインデントでサブリストがネストされ、同じインデントで他の要素もリスト項目の中に収められます。段落や引用はスペース4個、リスト内のコードブロックはスペース8個が必要です。標準のコードインデント4個分がリストのインデントの上に積み重なるためです。
ベストプラクティス:1つのリストでは記号を1種類に統一し、番号の後は括弧ではなくピリオドを使います。ピリオド形式はすべてのMarkdownアプリケーションで機能するためです。
コード
インラインコードはバッククォート1個ずつで囲み、コードブロックは半角スペース4個以上またはタブ1個でインデントした行のまとまりです。
Type `git status` to check the working tree.
<html>
<head></head>
</html>
バッククォートのペアは等幅フォントのcode要素としてレンダリングされ、インデントしたブロックはすべてのスペースを保持したままpreタグとcodeタグの中にレンダリングされます。バッククォート自体を含むスニペットは、バッククォート2個で囲む必要があります。たとえば the outer pair displays `code` literally のように書きます。バッククォート3個のフェンス付きコードブロックは拡張記法に属し、4スペースのインデントがオリジナルの方法です。
ベストプラクティス:文字としてのバッククォートはバッククォート2個で囲みます。こうするとコードスパンが途中で閉じず、内側の文字がそのまま表示されます。
水平線
水平線は、アスタリスク、ハイフン、またはアンダースコアを3個以上、単独の行に置いて作ります。
***
---
___
3つの書き方はすべて同一のhr要素、つまり全幅の区切り線としてレンダリングされます。記号は3個を超えて何個並べても出力は変わらず、ハイフン20個の行も3個の場合と同じ線になります。見出しでは重すぎる場面転換やセクションの区切りに、書き手はこの線を使います。
ベストプラクティス:各水平線の上下に空行を入れます。テキストの直下にハイフンだけの行を置くと、そのテキストがH2見出しに変わってしまうためです。
リンク
インラインリンクはリンクテキストを角括弧で囲み、その直後に丸括弧でURLを続けます。引用符付きのタイトルは省略可能です。
Read the [original spec](https://daringfireball.net/projects/markdown/ "Gruber's 2004 spec").
Reference style keeps prose clean: read the [original spec][1].
[1]: https://daringfireball.net/projects/markdown/
Bare addresses work in angle brackets: <https://example.com> and <mail@example.com>
どの形式もa要素としてレンダリングされ、タイトルテキストはホバー時にツールチップとして表示されます。参照スタイルのリンクはURLを文から切り離します。[1]のラベルはファイル内のどこにでも置ける定義を指すため、長いURLだらけの段落もソースのまま読みやすく保てます。山括弧は生のURLやメールアドレスを、余計なテキストなしでクリック可能なリンクに変換します。リンクには書式も適用でき、構文全体をアスタリスクで囲めば太字のリンクに、角括弧の中をバッククォートで囲めばコードとしてレンダリングされます。
ベストプラクティス:URL内のスペースは%20にエンコードします。こうすると完全なアドレスがすべてのプロセッサーで維持されます。
画像
画像は、感嘆符、角括弧内の代替テキスト、丸括弧内の画像パスまたはURLの順に書きます。
[](https://example.com/report)
1行目は、代替テキストをアクセシビリティ用ラベル、引用符付きタイトルをホバーテキストとするimg要素としてレンダリングされます。この構文はリンクの前に文字を1個足しただけの形です。2行目は画像の構文全体をリンクの中にネストしており、画像をクリックするとリンク先のURLが開きます。
ベストプラクティス:代替テキストには画像の内容を説明する文を書きます。スクリーンリーダーと検索エンジンは、画像の代わりにこのテキストを読み取るためです。
文字のエスケープ
書式用の文字の前にバックスラッシュ()を置くと、その文字はマークダウンの機能を発動せず、文字どおりに表示されます。
\* This line shows a literal asterisk, not a bullet point.
1968\. The escaped period stops this year from starting an ordered list.
バックスラッシュ自体は出力に一切現れず、直後の文字だけが印字されます。マークダウンがバックスラッシュでエスケープできる文字は12種類です。バックスラッシュ、バッククォート、アスタリスク、アンダースコア、波括弧、角括弧、丸括弧、シャープ記号、プラス記号、マイナス記号、ドット、感嘆符が対象です。2つ目の例はよくある落とし穴への対処で、数字とピリオドで始まる行は、エスケープがなければリスト項目になってしまいます。
ベストプラクティス:エスケープするのはこの12種類のリストにある文字だけにします。それ以外の文字の前に置いたバックスラッシュは、そのまま可視のバックスラッシュとして表示されるためです。
よくある質問
マークダウン記法の基本セットとは何ですか?
**基本記法とは、John Gruber氏の2004年のマークダウン設計ドキュメントに由来する11要素の機能セットで、ほぼすべてのMarkdownアプリケーションがその全部をサポートしています。**11の要素はプロセッサー間で一貫して動作するため、プラットフォームをまたいで使う文書には基本セットが最も安全な選択です。
マークダウンの見出しは何レベルまで対応していますか?
**マークダウンは6レベルの見出しに対応しており、1個から6個のシャープ記号で書き、HTMLタグのh1からh6に直接対応します。**下線を使う別記法がカバーするのは上位2レベルだけで、イコール記号がH1、ハイフンがH2です。
新しい段落を作らずに改行するにはどうすればよいですか?
**行末に半角スペースを2個付けるか、HTMLタグの <br> を使います。**どちらも現在の段落の中にbr要素をレンダリングします。空行は効果が異なり、段落を閉じて新しい段落を開きます。
基本記法だけで十分ですか?拡張記法は必要ですか?
**標準的な文書は基本記法でカバーでき、拡張記法はテーブル、フェンス付きコードブロック、脚注など、GFMをはじめとする後続仕様の要素を追加します。**互換性を最大化するにはまず基本セットから始め、対象プラットフォームの対応を確認してから拡張要素を加えます。