Markdown 目录生成器 - 在线 TOC 生成

1. 生成目录

代码块里的井号标题不会进入目录——这是有意过滤，避免把示例代码当成大纲。生成后抽查前两个链接能否跳转，再整篇粘贴。

1. 粘贴 Markdown 全文；工具会跳过代码围栏内的伪标题。
2. 设置最小与最大标题层级（常见从二级到四级），选择列表类型与编号样式。
3. 选择锚点风格后复制目录，或把目录插入文章开头。

2. 锚点在 GitHub 与 GitLab 间的差异

同一个中文或带标点的标题，GitHub 与 GitLab 生成的锚点 ID 可能不同（大小写、去掉标点的方式、是否剥离 HTML）。本工具提供 GitHub、GitLab 与自定义模板（可用占位符组合文本与 slug）。目标平台不同时，抽查前两个锚点能否跳转，不一致就换风格或按平台规则微调。

3. 编号与缩进怎么选

• 技术文档常用无序列表；规范类文档可用有序或点分编号方便引用章节。
• 缩进用空格时，嵌套层级在多数渲染器里更稳；无缩进适合扁平大纲。
• 目录本身不要再套一级「目录」标题进生成范围，否则会出现自引用噪音。

4. 什么时候不该用自动目录

• 标题里带行内代码或复杂链接时解析易错——这类复杂标题手写目录更稳。
• 文章不长（一屏半以内）时目录是噪音而非导航，可以省略。
• 标题层级跳级严重时，先整理标题再生成，否则目录缩进会误导读者。

5. 和预览、slugify 的配合

生成目录后，用 markdown-preview 快速扫一眼列表层级是否合理。若站点锚点规则与 GitHub 相差很大，可先用 slugify 理解「标题如何变成 URL 安全串」，再回到本页用自定义锚点模板对齐。目录链接一旦被外链引用，改标题等于改锚点——重大改标题要同步旧锚点重定向或保留旧标题别名。

6. 落地检查清单

• 确认最小层级没有把一级大标题重复塞进目录（许多站点一级只用于文题）。
• 中文标题锚点在部分静态站生成器会保留汉字，与 GitHub 风格不同——以目标站为准。
• 插入原文后保留一空行分隔，避免紧贴正文首段导致渲染粘连。

7. 小结与边界提醒

自动目录省的是滚动成本，换来的是锚点稳定性义务。把「标题即契约」写进写作规范：改标题前先搜站内旧锚点引用。本页帮你生成，但平台最终渲染规则仍要以线上为准。

8. 实践中的额外注意

• 先用小样本验证输出是否符合预期，再处理完整输入。
• 结果用于生产前，在目标环境再抽查一次边界数据。
• 本页处理均在浏览器本地完成，不会把内容上传到服务器。
• 若文档宣称与页面选项不一致，以页面实际控件为准并反馈修正。