Markdown 标题锚点
最后更新：2026-10-14
标题锚点 常见扩展
扩展语法。给标题追加 {#custom-id} 自定义锚点，再用 [文字](#custom-id) 实现页内跳转。做长文档目录、FAQ 回链、交叉引用的基础设施。
| 所属分组 | GFM 扩展 |
|---|---|
| 规范层级 | 常见扩展 |
| 规范版本 | CommonMark 0.31.2 + GFM |
📝 语法
## 标题 {#anchor}
[跳转文字](#anchor)▶ 在线示例
在左侧编辑 Markdown，右侧实时看效果
💡 要点
ℹ️ 说明 不写 {#id} 时多数渲染器按标题文字自动生成 slug；中文标题的 slug 规则各渲染器不一，长文档建议显式指定。
⚠️ 注意 GitHub 不支持 {#id} 语法，但会按标题文字自动生成锚点。
❓ 常见问题
Q 自动锚点的生成规则？
A 英文转小写、空格转连字符、去标点；中文各渲染器不同，常见是保留原文。
Q 本站支持吗？
A 教程页由构建器自动生成锚点，markdown-it-anchor 可选启用。
Q 跳转能平滑滚动吗？
A 加 CSS scroll-behavior: smooth 即可，Markdown 层面无感知。
📚 相关条目
标题CommonMark 核心