Skip to content

md 时标题级别应该如何正确使用

一、基础原则

‌层级递减,禁止跳跃‌

‌正确结构‌:H1 → H2 → H3 → H4 → ...(逐级递增) ‌错误结构‌:H1 → H3(跳过 H2)或 H2 → H4(结构断层)

H1 仅用于文档标题‌

每个文档 ‌仅有一个 H1‌(即首个 #),对应文件名或页面核心主题

markdown
# VitePress 部署指南  ✅ 唯一 H1

‌与目录生成器结合

markdown
[[toc]] // VitePress 自动生成基于标题层级的目录