標題是任何 Markdown 文件的支柱。它們定義結構、啟用導航、影響可訪問性並影響 SEO。本指南涵蓋了有關的所有內容 Markdown 標題 — 語法、層次結構規則、平臺差異和最佳實踐。
標題語法
Markdown 標題使用 # 符號（ATX 型）。數量 # 字元決定標題級別：
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6還有 Setext 樣式（僅 H1 和 H2）：
Heading 1
=========
Heading 2
---------ATX 型 (#) 是首選 - 它更明確並且適用於所有六個級別。
每個標題級別的含義
| 等級 | HTML 標籤 | 目的 |
|---|---|---|
| H1 | <h1> | 頁面或文件標題 |
| H2 | <h2> | 主要部分 |
| H3 | <h3> | H2 內的小節 |
| H4 | <h4> | H3 內的小節 |
| H5 | <h5> | 實踐中很少使用 |
| H6 | <h6> | 幾乎從來不需要 |
大多數文件僅使用 H1–H3。H4-H6通常表示文件結構太深。
H1：每頁一個
H1 標題應該在每個 Markdown 文件中恰好出現一次。它代表文件的標題或頁面的主要主題。
好：
# 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 H3跳過標題級別會破壞文件大綱，並且不符合 WCAG 可訪問性準則。
將Word標題轉換為 Markdown
當您使用以下命令轉換 Word 文件時 WordToMD，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
目錄
對於長文件，使用標題錨鏈接生成目錄：
## Table of Contents
- [Installation](#installation)
- [Configuration](#configuration)
- [Basic Settings](#basic-settings)
- [Advanced Options](#advanced-options)
- [Usage](#usage)
- [FAQ](#faq)GitHub 會自動在任何帶有標題的 Markdown 檔案的左上角生成目錄。
SEO 考慮因素
對於在靜態網站（Jekyll、Hugo、Astro）中使用併發布到網路上的 Markdown：
- H1 = 頁面標題 僅 — 包括您的主要關鍵字。每頁一張。
- H2s = 主要部分 — 自然地包含次要關鍵字
- H3s = 小節 — 更具體的主題
- 保持標題的描述性 — “如何安裝依賴項”勝過“安裝”
- 標題由搜尋引擎索引 - 使其可掃描
見 字到靜態站點生成器 用於將 Markdown 文件釋出到網路上。
輔助功能
螢幕閱讀器使用標題層次結構來幫助使用者導航。指南：
- 不要跳過標題級別（H1→H3，沒有 H2）
- 不要僅將標題用於視覺格式（使用粗體或 CSS 代替）
- 使標題文本有意義 - 避免“第 1 節”、“A 部分”
- 保持標題簡潔但具有描述性
按平臺的標題渲染
| 平臺 | H1-H6 | 自動 ID | 自動目錄 |
|---|---|---|---|
| GitHub | ✅ | ✅ | ✅（通過按鈕） |
| Obsidian | ✅ | ✅ | 通過外掛 |
| GitBook | ✅ | ✅ | ✅（側邊欄） |
| Notion | H1-H3 | ❌ | ❌ |
| VS 程式碼預覽 | ✅ | ✅ | ❌ |
| 匯合 | ✅ | ✅ | ✅ |
Notion 僅支援三個標題級別（在編輯器中稱為標題 1、2 和 3，對映到 H1–H3）。
常見錯誤
忘記後面的空格 #
#Not a heading ← Missing space
# This is correct之間的空間 # 並且 CommonMark 中需要標題文本。
使用標題來設計樣式，而不是結構
使用 ### 使文本稍微變小而不是實際的小節會破壞文件結構。請改用樣式文本或 CSS 類。
過度巢狀 如果您需要 H5 和 H6，請考慮是否應將內容拆分為單獨的頁面。
FAQ
ATX 和 Setext 標題樣式有什麼區別？
ATX用途 # 字元。Settext 使用下劃線 (=== ， --- 對於 H2)。ATX 是首選，因為它明確且適用於 H1-H6。
我可以擁有多個 H2 嗎？ 是的——這就是重點。H2 定義了主要部分，一個文件通常有幾個部分。
跳過標題級別會影響 SEO 嗎？ 它對可訪問性的影響比 SEO 更直接，但乾淨的語義結構是一個積極的訊號。搜尋引擎更喜歡結構良好的內容。
我轉換後的文件的所有標題都處於同一級別。出了什麼問題？ Word 文件使用手動格式而不是標題樣式。參見 Word 到 Markdown 格式指南 修復。
結論
Markdown 標題語法簡單，但影響力很重要。使用 H1 一次作為文件標題，H2 用作主要部分，H3 用作小節。保持層次結構清晰，不跳過任何級別，並編寫描述性標題文本。轉換 Word 文件時 WordToMD，確保源使用 Word 的內建標題樣式進行乾淨的轉換。