Markdown TOC 生成器(根据标题自动生成)

根据 Markdown 标题自动生成目录。选择标题层级(如 H2-H4)后,即可复制可编辑的输出并立即粘贴到文档中。

支持仅 H2、锚点模式以及重复标题处理,无需额外设置。

你的文本会保留在浏览器本地,绝不会上传。

使用方法(30 秒)

  1. 粘贴 Markdown 文本。
  2. 选择标题层级(仅 H2 / H2-H4 等)。
  3. 复制生成的目录,并粘贴到文档中。

输入与输出示例

带重复标题的示例

输入

# 文档标题
## 概览
## 用法
### 安装
### 设置
## FAQ
## FAQ

输出(H2-H3 / 无序列表 / 显示 TOC 标题)

## 目录

- [概览](#概览)
- [用法](#用法)
  - [安装](#安装)
  - [设置](#设置)
- [FAQ](#faq)
- [FAQ](#faq-2)

规格(锚点与重复规则)

标题提取规则

  • 会提取所选范围内的 ATX 标题(# 到 ####)。
  • 会忽略围栏代码块(``` ... ```)中的内容。
  • 可使用层级过滤(仅 H2 / H2-H3 / H2-H4 / H1-H4)。
  • 首个版本暂不支持 Setext 标题(=== / ---)。

锚点生成规则(工具规则)

  1. 先去除标题文本首尾空白。
  2. 英文字符转换为小写。
  3. 将空格转换为 -。
  4. 移除除 - 以外的符号。
  5. 将连续重复的 -- 折叠为单个 -。
  6. 移除开头和结尾的 -。
  7. 当锚点重复时,追加 -2、-3 ...。

TOC 链接行为会因托管平台和 Markdown 查看器而异。必要时请手动编辑输出。

常见问题

可以只生成 H2 的目录吗?

可以。在“标题层级”中选择“仅 H2”。

锚点文本是怎么决定的?

锚点会遵循本页说明的规则生成。你也可以选择“自定义”,或手动编辑输出。

重复标题会如何处理?

重复标题会自动追加 -2、-3 等后缀,以保证锚点唯一。

可以把某些标题排除在目录之外吗?

可以。在高级设置中使用“排除关键词”。

可以生成不带链接的目录吗?

可以。请选择锚点模式中的“无锚点”。

注意事项

  • 锚点行为会因 Markdown 环境不同而不同。
  • 输出是可编辑的,因此你可以针对目标渲染器做细调。
  • 输入文本仅在浏览器本地处理。

相关工具