构建完美文档树的关键是确保层级不跳、语义不混、结构不浮;必须严格遵循标题层级递进,用和语义容器合理组织内容模块,避免跳级与误用。

构建完美的文档树,关键不是让标题“看起来整齐”,而是让机器(搜索引擎、屏幕阅读器)和人一眼看懂内容的主次与逻辑关系。核心是层级不跳、语义不混、结构不浮。
严格遵循层级递进,禁用跳级
标题标签的本质是逻辑骨架,不是字号开关。
代表整页唯一主题,必须是它的直接子级,再隶属于某个,以此类推。跳级(比如后直接写)会破坏文档大纲,导致爬虫生成错误的结构图,也影响辅助技术导航。
- ✅ 正确:
产品首页
→ 核心功能
→ 实时同步
- ❌ 错误:
产品首页
→ 实时同步
(缺少承上启下)
- ⚠️ 注意:同一层级可多次出现(多个
没问题),但不能无中生有地“插队”
用 和 锚定局部标题上下文
再隶属于某个,以此类推。跳级(比如后直接写)会破坏文档大纲,导致爬虫生成错误的结构图,也影响辅助技术导航。
- ✅ 正确:
产品首页
→ 核心功能
→ 实时同步
- ❌ 错误:
产品首页
→ 实时同步
(缺少承上启下)
- ⚠️ 注意:同一层级可多次出现(多个
没问题),但不能无中生有地“插队”
用 和 锚定局部标题上下文
后直接写)会破坏文档大纲,导致爬虫生成错误的结构图,也影响辅助技术导航。
- ✅ 正确:
产品首页
→ 核心功能
→ 实时同步
- ❌ 错误:
产品首页
→ 实时同步
(缺少承上启下)
- ⚠️ 注意:同一层级可多次出现(多个
没问题),但不能无中生有地“插队”
用 和 锚定局部标题上下文
- ✅ 正确:
产品首页
→核心功能
→实时同步
- ❌ 错误:
产品首页
→实时同步
(缺少承上启下)
- ⚠️ 注意:同一层级可多次出现(多个
没问题),但不能无中生有地“插队”
用 和 锚定局部标题上下文
纯靠
–堆叠容易造成全局层级混乱。HTML5 提供了语义容器来“重置”标题起点——每个 或 内部可拥有自己的作为该模块的主标题,而不会与页面级冲突。
适合组织主题相关的内容组,如“用户评价”“技术参数”,每个开头必须带一个标题(或更合适级别)
用于独立成篇、可复用的内容,如博客文章、新闻条目;它内部可用作文章标题,作小节标题,逻辑自洽
- 避免把
硬塞进页脚或侧边栏——那不是内容模块,是干扰项
合理组合 与标题,强化语义环境
本身不表示标题级别,但它能明确告诉机器:“这里是一块有头儿的内容”。把放在主里,把放在的里,既符合视觉习惯,又提升可访问性。
- 主区域:
欢迎登录
安全、快速、一步到位
- 文章区块:
响应式设计实践
正文...
- 别把
当用:如果里面只有广告图或无关链接,就该换用或
作为该模块的主标题,而不会与页面级冲突。
适合组织主题相关的内容组,如“用户评价”“技术参数”,每个开头必须带一个标题(或更合适级别)
用于独立成篇、可复用的内容,如博客文章、新闻条目;它内部可用作文章标题,作小节标题,逻辑自洽
- 避免把
硬塞进页脚或侧边栏——那不是内容模块,是干扰项
合理组合 与标题,强化语义环境
适合组织主题相关的内容组,如“用户评价”“技术参数”,每个 开头必须带一个标题( 或更合适级别)
用于独立成篇、可复用的内容,如博客文章、新闻条目;它内部可用 作文章标题,
作小节标题,逻辑自洽
- 避免把
硬塞进页脚或侧边栏——那不是内容模块,是干扰项
合理组合 与标题,强化语义环境
放在主
放在
- 主区域:
欢迎登录
安全、快速、一步到位
- 文章区块:
响应式设计实践
正文...
- 别把
当 用:如果里面只有广告图或无关链接,就该换用或
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











