📑

Markdown 目录生成

扫描 Markdown 标题,生成带锚点链接的目录(TOC)。

本地处理 · 不上传

加载工具中…

相关:Markdown目录 · TOC · 目录生成 · 锚点 · 文档目录

Markdown 目录生成扫描文档中的各级标题,生成带锚点链接的目录列表,可指定层级范围。长文档加目录后阅读体验明显不同。

使用步骤

  1. 粘贴 Markdown 正文
  2. 设置要包含的标题层级
  3. 查看生成的目录
  4. 复制插入到文档开头

使用场景

  • 为 README 或技术文档添加导航目录
  • 整理长篇笔记的结构
  • 检查文档的标题层级是否合理
  • 生成用于站点侧边栏的大纲

小贴士

  • 锚点由标题文字生成:转小写、空格换连字符、去掉标点。中文标题在不同平台的锚点规则不同,跨平台使用需实测。
  • 标题重复时锚点会自动追加数字后缀,两个同名的「概述」分别对应 #概述 和 #概述-1。
  • 目录通常只收 H2 到 H3 两级就够,收到 H4 以下会让目录本身变得比正文还难读。

常见问题

目录链接点了没反应?

多半是锚点规则不匹配。GitHub、GitLab 与各类静态站点生成器的锚点生成规则存在差异,尤其在含中文或标点的标题上。

能自动更新吗?

生成的是静态文本,改了标题需要重新生成。若在文档工作流中固化,可用 markdown-toc 之类的命令行工具在提交前自动重建。

代码块里的井号会被当成标题吗?

不应该。规范的实现会跳过围栏代码块内的内容。若发现误识别,检查代码块的围栏是否正确闭合。

Markdown 目录生成是免费的吗?

是。本站所有工具完全免费,无需注册登录、无广告干扰,打开即用。

使用Markdown 目录生成,我的数据安全吗?

安全。该工具在你的浏览器本地完成处理,输入内容不会上传到服务器,隐私更有保障。