📑
Markdown 目录生成
扫描 Markdown 标题,生成带锚点链接的目录(TOC)。
本地处理 · 不上传
加载工具中…
相关:Markdown目录 · TOC · 目录生成 · 锚点 · 文档目录
Markdown 目录生成扫描文档中的各级标题,生成带锚点链接的目录列表,可指定层级范围。长文档加目录后阅读体验明显不同。
使用步骤
- 粘贴 Markdown 正文
- 设置要包含的标题层级
- 查看生成的目录
- 复制插入到文档开头
使用场景
- 为 README 或技术文档添加导航目录
- 整理长篇笔记的结构
- 检查文档的标题层级是否合理
- 生成用于站点侧边栏的大纲
小贴士
- 锚点由标题文字生成:转小写、空格换连字符、去掉标点。中文标题在不同平台的锚点规则不同,跨平台使用需实测。
- 标题重复时锚点会自动追加数字后缀,两个同名的「概述」分别对应 #概述 和 #概述-1。
- 目录通常只收 H2 到 H3 两级就够,收到 H4 以下会让目录本身变得比正文还难读。
常见问题
目录链接点了没反应?
多半是锚点规则不匹配。GitHub、GitLab 与各类静态站点生成器的锚点生成规则存在差异,尤其在含中文或标点的标题上。
能自动更新吗?
生成的是静态文本,改了标题需要重新生成。若在文档工作流中固化,可用 markdown-toc 之类的命令行工具在提交前自动重建。
代码块里的井号会被当成标题吗?
不应该。规范的实现会跳过围栏代码块内的内容。若发现误识别,检查代码块的围栏是否正确闭合。
Markdown 目录生成是免费的吗?
是。本站所有工具完全免费,无需注册登录、无广告干扰,打开即用。
使用Markdown 目录生成,我的数据安全吗?
安全。该工具在你的浏览器本地完成处理,输入内容不会上传到服务器,隐私更有保障。