Markdown 目次（TOC）ジェネレーター
使い方
Markdown を貼り付けると、見出しから目次が自動生成されます。最小・最大の見出しレベルを指定して目次に含める範囲を絞り込めます。インデント幅とリンク有無も切り替え可能です。生成結果はそのまま記事の冒頭に貼り付けられる Markdown 形式です。
目次（TOC）とは
目次（Table of Contents）は、長い記事の最初に配置して、読者にコンテンツの全体像を素早く伝えるためのナビゲーションです。本記事のような技術解説や仕様書では、目次があるかないかで読者の体験が大きく変わります。Markdown では `[見出し名](#anchor)` の形式で各見出しへリンクを張ります。アンカー名は GitHub などのレンダラーが見出し文字列から自動生成しますが、その規則を理解していないとリンクが切れる原因になります。
アンカー（スラッグ）生成のルール
GitHub Flavored Markdown のアンカー生成は次の規則に従います。1) すべて小文字に変換、2) 句読点と記号を削除、3) 空白をハイフンに置換、4) 同名の見出しが複数ある場合は `-1`、`-2` のように番号を付加。本ツールはこの規則に従ってアンカーを生成します。日本語見出しもそのまま使えますが、URL エンコードが必要になる場合があります。
主な用途
- ブログ記事 — 長い技術解説の冒頭に目次を挿入して読みやすくする
- README — GitHub リポジトリのドキュメントに見出しナビゲーションを追加
- 技術仕様書 — 章立てが多いドキュメントの全体像を提示
- ナレッジベース — Notion、Obsidian、HackMD など Markdown 対応エディタで目次を作成
- プレゼン資料 — Markdown ベースのスライドで全体構成を一覧化
目次設計のコツ
- H1（タイトル）は通常 1 つだけなので、目次には H2 以下を含めるのが一般的です
- H4 以下の小見出しは目次に入れず本文の構造に留めると、目次が読みやすくなります
- 日本語アンカーが URL エンコードで読みづらくなる場合は、見出しに英字 ID を付与する手もあります
- 同名の見出しを避けると、`-1` `-2` の番号付加によるリンク切れを防げます
- 目次は記事執筆後に再生成して、見出しの追加・変更を反映する習慣をつけると整合性が保てます
プライバシー
すべての処理はブラウザ内で完結します。入力された Markdown はサーバーに送信されません。
よくある質問
目次の自動生成と、Markdown のレンダラーが付ける自動リンクは何が違いますか？
このツールは見出しから目次の Markdown テキスト（リンク付き箇条書き）そのものを生成し、記事の冒頭に貼り付けられる形で出力します。GitHub などのレンダラーが行うのは各見出しへのアンカー付与だけで、目次本体は作りません。両者を組み合わせて初めてクリック可能な目次が機能します。
非公開の Markdown や社内ドキュメントを貼り付けても安全ですか？
はい。見出しの抽出と目次生成はすべてブラウザ内で完結し、入力した Markdown がサーバーに送信・保存・記録されることは一切ありません。未公開の記事や社内仕様書でも安心して貼り付けられます。
目次に含める見出しレベルはどこまで指定できますか？
最小・最大の見出しレベルを H1〜H6 の範囲で指定できます。たとえば最小を H2、最大を H3 にすると、タイトル（H1）と細かい H4 以下を除外したすっきりした目次になります。
日本語の見出しや同名の見出しがあるとアンカーはどうなりますか？
GitHub Flavored Markdown の規則に従い、小文字化・記号除去・空白のハイフン化を行います。日本語見出しはそのまま使われますが、リンク先では URL エンコードされることがあります。同名の見出しには `-1`、`-2` の番号が自動で付加されます。
見出しを追加・編集したら目次は自動で更新されますか？
入力欄の Markdown を変更すると目次はリアルタイムで再生成されます。ただし、すでに記事へ貼り付け済みの古い目次は自動では追従しないため、編集後に再生成してコピーし直してください。