工具加载中...
Markdown 目录生成器简介
Markdown 目录生成器可以从 Markdown 文章中自动提取标题,快速生成文章目录、内容大纲和 TOC。工具支持 Markdown 目录格式与 HTML 目录代码,适合博客、技术文档、产品说明、知识库和项目 README 使用。
主要功能
- 识别一级到六级 ATX 标题,例如 # 标题、## 小节。
- 识别使用等号或短横线标记的 Setext 标题。
- 自动生成标题锚点,重复标题会追加序号,避免目录链接冲突。
- 支持设置最低和最高标题级别,生成更适合文章结构的目录。
- 支持输出 Markdown 无序列表或 HTML 目录代码,可复制和下载。
- 自动忽略围栏代码块中的标题,避免示例代码干扰实际目录。
使用方法
第一步:粘贴 Markdown 文章内容,或点击导入 Markdown 读取本地文件。
第二步:选择 Markdown 目录或 HTML 目录输出格式。
第三步:按需要设置最低级别和最高级别,点击生成目录。
第四步:复制生成的 TOC 内容,或下载目录文件并添加到文章中。
适用场景
写作人员可以用它为长篇文章生成可点击目录,开发者可以为 README、接口文档和项目说明添加 TOC,网站编辑也可以通过 HTML 输出快速制作文章导航。设置标题范围后,还能只提取文章的大纲层级或章节小节。
常见问题
为什么代码块中的标题没有出现在目录中?
工具会识别常见的反引号或波浪线围栏代码块,并主动忽略其中的内容,这是为了避免代码示例里的 # 文本被误判为文章标题。
重复标题的链接会冲突吗?
不会。相同标题会按出现顺序生成基础锚点、带有 -2、-3 等后缀的锚点,目录链接可以分别定位到对应章节。
可以只生成二级和三级标题吗?
可以,将最低级别设置为 2、最高级别设置为 3,工具就会过滤其他标题级别。
HTML 输出包含完整页面吗?
HTML 模式输出的是可嵌入页面的目录列表代码,包含 markdown-toc 类名和标题级别类名,您可以在网站中继续添加自己的样式。