可配置的标题级别范围
选择要包含的最小标题级别（H1 到 H6）和最大级别。默认为 最小 2，最大 4——跳过 H1（通常是页面标题，不应出现在自身的目录中）和 H5/H6（通常过于细粒度）。长技术文档通常用 2-4；短文章用 2-3；详尽的参考文档可能需要 2-6。
如需将 Markdown 处理为完整的 AST 进行自定义处理，使用 免费 Markdown 转 JSON 工具。
Markdown TOC 生成器
根据 Markdown 标题自动生成目录。
概述 — 免费 Markdown TOC 生成器 的功能
这个免费工具是什么
免费 Markdown 目录生成器扫描您的 Markdown 标题并生成带锚点链接的嵌套目录。每个标题都会成为指向文档中对应锚点的链接。粘贴 Markdown、选择标题级别范围，即可将生成的目录复制到文档顶部。
隐私: 此工具完全在您的浏览器中运行。您的文本不会被上传、记录或缓存。关闭标签页即消失。可在开发者工具 → 网络中验证：零请求发出。
为什么免费（以及我们如何保持免费）
使用概览
速查参考
| 输入 | 输出 | 典型大小 | 速度 | 需要登录 |
|---|---|---|---|---|
| Markdown with headings | Nested TOC (Markdown or HTML) | Any size | < 10 ms | No |
Markdown TOC 生成器 功能
以下是此免费工具的详细功能 — 每项功能都旨在解决实际问题，完全在浏览器中运行，永久免费。
Markdown 或 HTML 输出
在 Markdown（缩进项目符号列表加链接语法）和 HTML（嵌套 <ul> 加 <li> 和 <a> 标签）之间切换。Markdown 输出可在所有 Markdown 渲染器中使用——GitHub、GitLab、Obsidian、Notion 等。HTML 输出适合将整个文档转换为 HTML 时使用。
搭配 免费 Markdown 转 HTML 转换器使用：先生成目录，添加到 Markdown 顶部，然后转换整个文档。
自动生成锚点链接
每个目录条目链接到一个根据标题文本计算的锚点，使用标准的 GitHub 兼容 slug 算法：文本转小写、空格替换为连字符、移除非字母数字字符。这些锚点与 GitHub、GitLab 等渲染器自动生成的锚点一致。
如需相同内容的纯文本版本（无链接、无格式），使用 免费 Markdown 转纯文本工具。
重复标题处理
如果文档中有两个相同文本的标题（如两个 ## 安装），工具会为重复项生成编号的唯一锚点：#安装、#安装-1、#安装-2。这与 GitHub 的行为一致，确保每个目录条目链接到唯一位置。
可选的目录标题
可在输出顶部包含或排除 ## 目录 标题。默认包含。也可自定义标题文本——如 # 内容、## 章节 或本地化版本如 ## 目录。
发布前可使用 免费 Markdown 格式化工具规范标题间距和列表标记。
如何使用免费 Markdown TOC 生成器
步骤 1 — 粘贴 Markdown
将包含标题的文档粘贴到输入区域。
步骤 2 — 设置标题级别范围
选择最小级别（通常为 2 以跳过 H1）和最大级别（通常为 3 或 4）。
步骤 3 — 复制目录
点击复制，将结果粘贴到文档顶部。
谁可以使用此工具
Technical writers
Adding navigation to long documentation pages before publishing.
GitHub README authors
Adding a table of contents to long README files for easier navigation.
Bloggers with long-form posts
Adding TOCs to 2000+ word posts so readers can jump to sections.
Students writing thesis drafts
Generating TOCs for Markdown thesis drafts before final conversion to PDF or DOCX.
Book authors
Building nested chapter TOCs for Markdown-based book drafts.
常见问题
这个目录生成器真的免费吗？
是的。freemarkdowntools.com 上的所有工具永久免费。
会生成锚点链接吗？
是的。每个条目使用标准 GitHub 兼容 slug 格式链接到锚点（小写、连字符、重复项编号）。
可以只包含 H2-H3 吗？
可以。在选项中将最小级别设为 2，最大级别设为 3。
能处理重复标题吗？
能。重复标题会获得编号后缀，确保每个锚点唯一。
Markdown 还是 HTML 输出？
两者都支持。在选项面板中切换。Markdown 是项目符号列表；HTML 是嵌套的
- 。