Markdown 目录生成器

使用步骤

1. 把 Markdown 粘贴到左侧输入区。
2. 在 锚点风格 里选目标平台 — GitHub / Hugo、GitLab、Jekyll 或 Bitbucket。
3. 用 最小标题级别 与 最大标题级别 圈定要进 TOC 的层级范围。
4. 如果文档标题由模板单独渲染，关掉 包含 H1。
5. 直接复制生成的目录；或者打开 标记模式，得到带 <!— toc —> 标记的完整 Markdown。

四种锚点风格

• GitHub / Hugo — 转小写、去标点、空格转连字符、保留 Unicode。Hugo 自 v0.62 起的 goldmark 渲染器默认与 GitHub 一致。
• GitLab — 同 GitHub，但把连续多个连字符合并为一个，匹配 GitLab Flavored Markdown。
• Jekyll（kramdown 经典） — 先剥掉所有非 ASCII 字符再生成 slug。仅在 Jekyll 站没有切换到支持 Unicode 的 slugger 时使用。
• Bitbucket — 每个锚点都带 markdown- 前缀，重复项用 _N 而非 -N。

标记模式

标记模式让 TOC 永远新鲜，又不动原文其它部分。 在你想放目录的位置写两条 HTML 注释：

<!— toc —>
<!— /toc —>

之后随时跑一遍生成器，两条注释之间的内容会被替换为新 TOC。 如果文档还没有标记，工具会在第一个标题之前自动插入一段标记块， 复制粘贴回去就能 commit。

实例

简单目录，GitHub 风格

输入：

# API 参考

## 鉴权

### OAuth 流程

## 接口

### GET /users
### POST /users

输出（GitHub 锚点，缩进 2 空格）：

- [API 参考](#api-参考)
  - [鉴权](#鉴权)
    - [OAuth 流程](#oauth-流程)
  - [接口](#接口)
    - [GET /users](#get-users)
    - [POST /users](#post-users)

重复标题

两个 ## 示例 在 GitHub / GitLab / Jekyll 下分别变成 #示例 和 #示例-1；Bitbucket 下变成 #markdown-示例 和 #markdown-示例_1。

跳过 H1

如果你的静态站从 frontmatter 渲染 H1，关掉 包含 H1，TOC 会从第一个 H2 开始，整体缩进降一级。