装完 markdowntoc 插件没反应，本质是装错插件——正确插件名为 table of contents（作者 thomaspark），需通过 package control 严格输入该名称安装并重启 sublime；若状态栏未显示 markdown 语法或光标位于代码块内，toc 命令亦会静默失效。
装完 MarkdownTOC 插件没反应？先确认是否真装对了
很多人搜“toc”装了 Markdown TOC 或 MarkdownToc，结果命令面板里找不到 TOC: Insert Table of Contents——大概率是名字没输准。真正能用的插件名是 Table of Contents（作者 thomaspark），不是带 “Markdown” 前缀的变体。
正确路径：打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入 Package Control: Install Package → 等列表加载完成 → 严格输入 Table of Contents（注意空格和大小写）→ 回车安装。
- 装完必须重启 Sublime Text，否则命令不注册（ST3/ST4 均有此现象）
- 别和
MarkdownPreview混淆：MarkdownPreview只渲染 HTML，不生成目录；Table of Contents才负责插入和更新 TOC - 检查是否生效：重启后，在 .md 文件里按
Ctrl+Shift+P输入TOC，能看到TOC: Insert Table of Contents和TOC: Update Table of Contents两项
为什么光标放对位置，TOC 还插不进去？
插件只在当前文件类型为 Markdown 时才激活——不是后缀名 .md 就算数，得看右下角状态栏是否显示 Markdown。如果显示 Plain text，即使文件名是 readme.md，TOC: Insert Table of Contents 也会静默失败。
pdf文档转markdown
下载
将PDF文件（含扫描件、图片）转换为Markdown格式。接入MinerU和PaddleOCR双引擎，支持扫描件OCR识别、公式表格解析、多语言识别。兼容本地OCR识别。
- 手动切换语法：右下角点击语言名 → 选
Markdown（或按Ctrl+Shift+P输入Set Syntax: Markdown） - 确保文件已保存：未保存的临时文件可能无法识别类型
- 光标必须落在 Markdown 区域内（不能在代码块、引用块或 HTML 标签里），否则插件跳过处理
- 插入位置影响后续编辑：建议放在
# 文档标题下一行，避免被误删或格式错乱
MarkdownTOC 和 Table of Contents 插件有什么区别？别混用
这两个是不同作者、不同实现逻辑的插件，行为差异明显，混装会导致命令冲突或 TOC 渲染异常。
-
Table of Contents（推荐）：轻量、专注、实时更新支持好；生成的 TOC 是纯 Markdown 列表（- [标题](#xxx)），兼容所有预览器；不依赖额外配置 -
MarkdownTOC：功能更细（如支持ordered序号、autoanchor控制锚点编码），但需手动改MarkdownTOC.sublime-settings；默认开启uri_encoding时中文锚点在 IE/360 里失效，关掉才通用 - 二者不能共存：同时启用会抢
Ctrl+Shift+P的 TOC 命令，且MarkdownTOC的自动更新可能覆盖Table of Contents手动插入的内容
生成的 TOC 点不了跳转？检查锚点生成逻辑
目录项能显示，但点击没反应，问题几乎都出在锚点上——不是插件没生成，而是 Markdown 渲染器没解析出对应 ID。
- 确认预览器支持锚点：用
Markdown Preview插件预览（Ctrl+Shift+P→Markdown Preview: Preview in Browser），不要只靠 Sublime 内置的简单渲染 - 标题中含特殊字符（如
「」、/、&）时，Table of Contents默认会转成 URL-safe 形式（如hello-world），但某些旧版渲染器不匹配；可临时用纯英文标题测试 - 如果用了
MarkdownTOC，检查"uri_encoding": false是否生效，否则中文标题锚点（如#使用说明）会被编码成%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E，而浏览器可能不识别
最稳的做法：用 Table of Contents + Markdown Preview 组合，不调参数，不碰设置文件，99% 场景下锚点跳转正常。复杂需求（比如要罗马序号或自定义缩进）再考虑 MarkdownTOC，但得接受它需要手动调参、容易踩坑。
