Markdown 目次ジェネレーター｜見出しから貼り付け可能な TOC を生成

Markdown 本文の見出し（H1〜H6）を読み取り、そのまま記事冒頭に貼り付けられる目次を組み立てるツールです。深さ・箇条書き/番号付き・GitHub アンカーを選ぶだけで、整形済みの Markdown が目次欄に出力されます。

💡 このツールについて

長い技術記事や README を書いていると、本文を直したびに目次の見出しとアンカーを手で書き換える羽目になります。見出しを 1 つ追加し忘れる、アンカーのスペルがずれてリンクが飛ばない——こうした地味な手戻りは、記事が長くなるほど増えていきます。

このツールは本文をまるごと貼り付けるだけで、見出し階層をそのまま反映した目次を作ります。ネストはインデント 2 スペースで表現され、GitHub アンカーは小文字化・スペースをハイフン置換・記号除去という GitHub の方式にそろえてあります。コードフェンス（`` や ~~~ で囲んだブロック）の中にある#` はコメントやシェルのプロンプトであって見出しではないため、解析対象から自動で外します。

🧐 よくある質問

Q. H1 も目次に含まれますか? 見出し深さで H2〜H6 を選べます。記事タイトルを H1 にしている場合、H2 以下を目次にすると本文構造だけを拾えます。

Q. GitHub アンカーは本当に GitHub で機能しますか? GitHub の見出しアンカー規則（小文字化・空白をハイフン・英数字とハイフン/アンダースコア以外を除去）に合わせています。日本語見出しはアンカーが空になりやすいので、その場合は「なし」を選んでテキストだけの目次にするのが無難です。

Q. コードブロック内の # コメント を見出しと間違えませんか? ``` または ~~~ で開いたフェンスの内側は見出し解析からスキップします。開始と同じ記号で閉じるまでをコード扱いします。

Q. 番号付きリストの番号はどう振られますか? すべて 1. で出力します。Markdown レンダラが連番を自動採番するため、ソース上は 1. のままで問題ありません。

Q. ネストの深さはどう決まりますか? 拾った見出しの中で最も浅いレベルを基準に、相対的な深さでインデントします。記事が H2 始まりでも H3 始まりでも、見た目の階層が崩れません。

📚 目次と日本語アンカーの豆知識

日本語の技術記事プラットフォームでは、見出しアンカーの扱いが場所によって違います。GitHub 方式のアンカー生成はラテン文字前提で設計されているため、日本語見出しをそのまま GitHub アンカーにすると記号除去で文字が消えてしまうことがあります。日本語見出し中心の記事なら、リンク無しのプレーンな目次を出力し、レンダラ側のアンカー付与に任せたほうが事故が少なくなります。GitHub の README や英語混じりの OSS ドキュメントでは GitHub アンカーがそのまま効くので、用途で使い分けるのがコツです。