タイトルは Markdown 文書の骨髄です 構造を定義し,ナビゲーションを可能にし,アクセシビリティに影響を与え, SEO に影響を与えます. このガイドでは Markdown 項目 構文,階層規則,プラットフォームの違い,ベストプラクティス
タイトル構文
Markdown の見出しは # シンボル (ATX様式) 2 年間 # キャラクター タイトルレベルを決定します
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6また,Setextスタイル (H1とH2のみ) もあります.
Heading 1
=========
Heading 2
---------ATX型 (#より明示的で6つのレベルすべてに有効です.
各 部 の レベル の 意味
| レベル | HTML タグ | 目的 |
|---|---|---|
| H1 | <h1> | ページまたはドキュメントのタイトル |
| H2 | <h2> | 主要セクション |
| H3 | <h3> | H2内のサブセクション |
| H4 | <h4> | H3内のサブセクション |
| H5 | <h5> | 稀に用いられる |
| H6 | <h6> | ほとんど必要ない |
ほとんどの文書はH1H3のみを使用しています. H4H6 は通常,文書構造があまりにも深いことを示します.
H1: ページごとに1ページ
H1の見出しは Markdown 文書ごとに正確に1回表示されるべきです. 文書のタイトルやページの主なテーマを表します.
いいわ
# How to Convert Word to Markdown避けるべきこと
# Section One
...
# Section Two ← Don't use multiple H1s検索エンジンやアクセシビリティ ツールでは,ページに単一のH1が期待されます. 複数のH1は両方を混乱させる.
タイトル階層規則
常に順番で進みなさい レベルを逃さないで
正解:
# Document Title
## Section
### Subsection
#### Detail間違っています
# Document Title
#### Jumped to H4 ← Skips H2 and H3WCAGのアクセシビリティガイドラインに違反する.
Wordヘッダを Markdown に変換する
Word で変換するときに WordToMD, Wordの内蔵のヘッドスタイルを直接マップします:
| Word スタイル | Markdown 出力 |
|---|---|
| 第1号目 | # Heading |
| 第2号目 | ## Heading |
| 第3項 | ### Heading |
| 正常 + 太った文字 | **Bold text** (タイトルなし) |
最も一般的な問題は,ヘッディングスタイルの代わりに手動でボールドでフォントサイズを増やします. これは Word のヘッダのように見えるテキストを作成しますが, Markdown の シンプルなボールドテキストに変換します. 参照 Word から Markdown フォーマットガイド 解決方法についてです
タイトルIDとアンカーリンク
ほとんどの Markdown プロセッサは,タイトルテキストから自動的に ID を生成します.
## Getting Started発電機: <h2 id="getting-started">Getting Started</h2>
リンクできます
See the [Getting Started section](#getting-started).自動生成IDに関する規則:
- 小文字のすべて
- 隙間を交差符で置き換える
- 特別文字を除いて,線を抜く
例:
## API Reference→#api-reference## What's New?→#whats-new## Step 1: Install→#step-1-install
内容 表
長い文書では,タイトルアンカーリンクを使用してTOCを生成します.
## Table of Contents
- [Installation](#installation)
- [Configuration](#configuration)
- [Basic Settings](#basic-settings)
- [Advanced Options](#advanced-options)
- [Usage](#usage)
- [FAQ](#faq)GitHubは,タイトルを持つ任意の Markdown ファイルの左上角で自動的にTOCを生成します.
SEO 考慮事項
静的サイト (Jekyll,Hugo,Astro) で使用され,ウェブに公開された Markdown に対して:
- H1 = ページタイトル 主要なキーワードを入力してください. ページごとに"枚
- H2s = 主要セクション 副次キーワードを自然に入力する
- H3s =サブセクション 具体的なテーマ
- 見出しは具体的にしましょう。「インストール」よりも「依存関係のインストール方法」の方が明確です
- 検索エンジンによってインデックスされる スキャン可能にする
参照 Word ステティックサイトジェネレーターへ ウェブに Markdown ドキュメントを公開するために
アクセシビリティ
スクリーンリーダーでは,ヘッダの階層がユーザのナビゲーションを助けます. ガイドライン
- ターゲットのレベル (H1 → H3 H2なし) をスキップしないでください.
- タイトルを視覚的なフォーマットにだけ使わないで下さい (代わりに大文字またはCSSを使用してください)
- タイトルテキストを意味のあるものにすること 第1節,第A節を避けること
- タイトル は 簡潔 に 記述 し て ください
プラットフォームによる表記表記
| プラットフォーム | H1-H6 | オートID | オート・TOC |
|---|---|---|---|
| GitHub | ✅ | ✅ | ✅ (ボタンを介して) |
| Obsidian | ✅ | ✅ | プラグイン経由で |
| GitBook | ✅ | ✅ | ✅ (サイドバー) |
| Notion | H1-H3のみ | ❌ | ❌ |
| VS コードプレビュー | ✅ | ✅ | ❌ |
| Confluence | ✅ | ✅ | ✅ |
Notionは3つのヘッダーレベルのみをサポートしています (編集ではヘッダー1,2,3と呼び出し,マッピングはH1H3です).
常 に 犯す 間違い
空間を忘れること #
#Not a heading ← Missing space
# This is correctこの間にある空間は, # タイトル文は CommonMark で要求されます.
スタイリングではなく構造のために見出しを使用する
使用する ### テキストを少し小さくして 本物のサブセクションでないと 文書の構造を壊します スタイリングされたテキストやCSSクラスを使用します.
過剰な巣を作る H5 と H6 が 必要であれば,そのコンテンツを別々のページに分割すべきかどうか検討してください.
FAQ
ATXとSetextのヘッドスタイルの違いは?
ATXの使用 # キャラクター Setextは,その利用を強調している (=== H1について --- H2について) ATXは曖昧で H1H6 に効くため好ましい.
H2を複数取ってもいいですか? そうだ ポイントはこれだ H2 は主要なセクションを定義し,文書には通常いくつかの部分があります.
コースレベルを跳ねると SEO に影響する? SEOよりもアクセス性に直接影響しますが 清潔な意味構造は 肯定的な信号です 検索エンジンはよく構造化されたコンテンツを好む.
私の変換された文書は,すべてのタイトルが同じレベルにある. どうしたんだ? Word 文書は,ヘッディングスタイルではなく手動形式化を使用しました. 参照 Word から Markdown フォーマットガイド 薬の為に
結論
Markdown ヘッダはシンタキシでシンプルですが,影響は重要です. 文書のタイトルとしてH1を1回,主要セクションではH2,サブセクションではH3を使用します. 階層をきれいにし,レベルを跳ねないこと,説明的なヘッドテキストを書いてください. Word ドキュメントを WordToMD, ソースが Word の内蔵ヘッディングスタイルをクリーンな変換に使用していることを確認します.