Sublime Text 的 MarkdownTOC 插件需手动触发插入目录，不自动执行；必须重启、文件为 .md 后缀、右下角显示 Markdown 且光标定位准确，三者缺一不可；中文标题跳转失效时需配置 "slugify": true 和 "uri_encoding": false。
不能自动在文档开头生成目录索引——Sublime Text 的 MarkdownTOC 插件从不自动插入，必须手动触发，且光标位置决定插入点。
安装 MarkdownTOC 插件时名称和来源必须严格匹配
搜 Package Control: Install Package 时输入 MarkdownTOC（注意是 TOC，不是 toc、TOC2 或 AutoTOC），作者是 jonschlinkert。装错名字的变体（比如 Markdown Toc 中间带空格）会导致命令不可用或快捷键失效。安装后必须重启 Sublime Text，否则 MarkdownTOC: Insert/Update 命令不会出现在命令面板里。
生成目录前必须满足三个硬性条件
缺一不可，否则会静默失败或生成空列表：
- 文件已保存为
.md或.markdown后缀 - 右下角状态栏显示
Markdown（不是Plain text；若显示错误，先用Ctrl+Shift+P→Set Syntax: Markdown手动切换） - 光标置于目标位置（如文档最顶部、
# 标题下一行等），插件不会“自动找开头”，它只把 TOC 插入当前光标处
中文标题锚点失效？检查 slugify 和 uri_encoding 设置
默认情况下，## 中文小节 生成的链接可能是 [中文小节](#%E4%B8%AD%E6%96%87%E5%B0%8F%E8%8A%82)，部分浏览器（如 IE、360）无法跳转。解决方法是修改配置：
打开 Preferences → Package Settings → MarkdownTOC → Settings – User，写入：
{
"slugify": true,
"uri_encoding": false
}其中 slugify: true 把中文转成拼音（如 zhong-wen-xiao-jie），uri_encoding: false 禁用 URL 编码，确保所有主流浏览器都能点击跳转。
按快捷键没反应？优先排查命令面板调用路径
别依赖菜单栏或右键——MarkdownTOC 没有默认快捷键绑定。正确流程是：
- 确保文件类型为 Markdown（见上一条）
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入
MarkdownTOC: Insert/Update（注意大小写和冒号），回车 - 如果命令不出现，说明插件未加载成功，重启 Sublime 后重试
插件不监听文件保存事件，也不扫描标题变化，每次更新都得手动再执行一次命令。
