Markdown 見出しID
最終更新：2026-10-14
見出しID よくある拡張
拡張構文です。見出しに {#custom-id} を追加してカスタムアンカーを設定し、[テキスト](#custom-id) でページ内ジャンプを実現します。長い文書の目次、FAQ への戻りリンク、相互参照を作るための基盤です。
| 所属グループ | GFM 拡張 |
|---|---|
| 仕様レベル | よくある拡張 |
| 仕様バージョン | CommonMark 0.31.2 + GFM |
📝 構文
## 見出し {#anchor}
[ジャンプ用テキスト](#anchor)▶ オンライン例
左で Markdown を編集すると右に即時反映
💡 ポイント
ℹ️ Note {#id} を書かない場合、多くのレンダラは見出しのテキストから slug を自動生成します。日本語見出しの slug 規則はレンダラごとに異なるため、長い文書では明示的に指定するのがおすすめです。
⚠️ Warning GitHub は {#id} 構文に対応していませんが、見出しのテキストからアンカーを自動生成します。
❓ よくある質問
Q 自動アンカーの生成規則は？
A 英字は小文字化、スペースはハイフン化、記号は削除が基本です。日本語の扱いはレンダラごとに異なり、原文をそのまま残すのが一般的です。
Q 本サイトでは使えますか？
A チュートリアルページはビルダーがアンカーを自動生成し、markdown-it-anchor はオプションで有効化できます。
Q ジャンプ時にスムーズスクロールできますか？
A CSS の scroll-behavior: smooth を追加するだけです。Markdown のレイヤーでは意識する必要がありません。
📚 関連項目
見出しCommonMark コア