sublime text 需通过 table of contents 插件生成 markdown 目录，安装后重启，确保文件为 .md 后缀且含 # 标题，调用 toc: insert table of contents 命令插入；需配置 min_depth=1 才包含一级标题。
Sublime Text 本身不内置 Markdown 目录生成功能，但通过 MarkdownPreview 或更专注的 Table of Contents 插件可以稳定实现——后者专为 TOC 设计，支持实时更新、点击跳转和多级标题识别，推荐优先使用。
安装 Table of Contents 插件（最简路径）
该插件由 thomaspark 维护，兼容 Sublime Text 3/4，无需额外依赖：
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入Package Control: Install Package - 搜索并安装
Table of Contents（注意名称精确，不是Markdown TOC或其他变体） - 安装后重启 Sublime（部分版本需手动重启才加载命令）
生成 TOC 的正确触发方式
插件不会自动插入目录，必须显式调用；且仅对当前文件类型为 Markdown 时生效（即右下角状态栏显示 Markdown，而非 Plain text）：
- 确保文件已保存为
.md或.markdown后缀 - 将光标置于想插入 TOC 的位置（通常在文档顶部或
# 概述下方） - 再次打开命令面板，输入
TOC: Insert Table of Contents并回车 - 默认生成的 TOC 使用
[title](#heading-id)形式，与 GitHub/GitLab 渲染完全兼容
常见失效原因与修复
生成失败通常不是插件问题，而是环境或操作细节未满足：
-
Command not found：说明插件未正确安装或未启用，检查Preferences → Package Settings → Table of Contents是否存在 - 生成内容为空或只有
#：确认文档中至少有一个以#开头的标题行（注意空格），且无缩进或前置字符 - 链接无法跳转：Sublime 原生不解析锚点，需配合
MarkdownPreview插件在浏览器中预览，或使用支持内联预览的插件如Markmap - 中文标题 ID 不规范：插件默认将中文转为 ASCII（如
## 项目结构→#%E9%A1%B9%E7%9B%AE%E7%BB%93%E6%9E%84），若需可读 ID，需在插件设置中开启"slugify": true并配置slugify_mode
{
"slugify": true,
"slugify_mode": "github"
}插件默认忽略 h1（#）级别标题，只从 h2（##）开始生成；如果需要包含一级标题，必须修改插件用户配置里的 "min_depth" 值为 1——这个细节几乎没人主动查，但直接影响 TOC 完整性。
