0002. 本文の見出し構造を正規化し、本文は h2 起点・h1 重複なしを規約とする

Status: Accepted（2026-06-26 決定）

Context（背景）

• レイアウトが記事タイトルを <h1> として出力しているのに、本文先頭も # タイトル（h1）で始まっており、1ページに h1 が2つ存在していた（全1751記事中1745記事）
• さらにレベル飛び（h2→h4 等）や h3 始まりの記事が多数あり、見出し階層が崩れていた
• SEO/アクセシビリティ上、h1 は1つ・階層は1段ずつが望ましい

Decision（決定）

• 本文の先頭 h1 はハイブリッド方式で解消する（ユーザ選択）
  • h1 テキストがタイトルとほぼ同じ（一致 or 包含）→ その行を削除（1447件）
  • 明確に異なる説明的 h1 → ## へ降格して文言を残す（297件）
• 本文途中で大見出しに使われていた正当な h1 は、最初の h1 以降を1段降格して解消（23件、markdown.md の実演用 h1 は除外）
• 見出しレベルの飛び/非h2始まりは、文書順の入れ子深さに応じて h2 起点で連番に振り直す正規化で解消（32記事）
• 以後の規約として AGENTS.md「基本的に守ってほしいこと」に明記
  • 本文に #(h1) は書かない（本文は ## から始める）
  • 見出しレベルは飛ばさない（1段ずつ深くする）

検討した代替案

• 全削除（先頭 h1 を一律削除）: 階層は最も綺麗だが、説明的 h1 の文言（日本語名・補足）が失われるため不採用
• 全降格（#→##）: 文言は残るがタイトルが本文に ## タイトル として重複し、各セクションが1段深くなるため不採用

Consequences（影響）

• 本文の h1 は 1745→1 に（残る1は markdown.md の意図的な実演）、レベル飛び/非h2始まりは 0
• 1745＋32 ファイルに渡る大規模変更だが、チェッカー＋ドライランで安全に実施
• 新規記事は本文 ## 始まりで書く必要がある（規約化済み）

参考

• 上位の方針: [[0001-seo-technical-scope]]
• 規約: AGENTS.md の「基本的に守ってほしいこと」