标题是任何 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 的内置标题样式进行干净的转换。