vscode markdown目录命令不出现，需先确认文件语言模式为markdown且已启用markdown all in one插件；中文标题跳转失效应将slugifymode设为vscode；updateonsave仅更新已有目录块，首次须手动执行命令；侧边栏大纲需同时开启explorer.experimental.showoutline、outline.automaticcollapse为false，并确保语言模式正确。

命令不出现？先确认文件和插件状态

最常见的情况是 Markdown: Create Table of Contents 命令根本没出现在命令面板里。这不是插件坏了，而是 VSCode 没把它当 Markdown 文件处理。

• 看右下角状态栏：必须显示 Markdown，不是 Plain Text 或其他语言模式；按 Ctrl+K M（Windows/Linux）或 Cmd+K M（macOS），输入 markdown 回车强制切换
• 打开扩展面板（Ctrl+Shift+X），搜 Markdown All in One，确认右侧开关是开启状态
• 重启 VSCode——尤其在刚安装或更新后，语言服务可能没加载完，导致命令未注册

中文标题链接点不动？改 slugifyMode 就行

生成的目录项如 - [配置说明](#配置说明) 在 GitHub 或 Docsify 上能跳转，但在 VSCode 内置预览里点不了，本质是锚点 ID 生成规则不匹配：VSCode 预览把中文转成 %E9%85%8D%E7%BD%AE 这类 URL 编码，而插件默认用 github 模式生成原始文本链接。

• 打开设置（Ctrl+,），搜 markdown.extension.toc.slugifyMode
• 把值从默认的 github 改成 vscode
• 删掉已有目录块，重新运行 Markdown: Create Table of Contents ——旧目录不会自动重写，必须手动触发

updateOnSave 设了 true 却不更新？它只刷新已有目录块

markdown.extension.toc.updateOnSave 不是“监听所有标题变化然后重写整个 TOC”，它的作用非常具体：只在保存时，扫描文档中已存在的、由该插件生成的目录（即以 - [ 开头的列表），并就地更新其中的链接和层级。

Web fetch markdown of page

通过 jina.ai 将网页抓取为精简的 markdown，用于在需要获取 URL 并获取压缩的 markdown 内容以节省 token。触发词 l...

下载

• 首次必须手动运行命令生成初始目录，否则插件找不到目标块
• 后续增删改标题后，只要没删掉整个目录块，保存就会刷新它
• 如果误删了目录，想恢复自动更新，得再手动执行一次命令——不是改设置就能“唤醒”
• 配置路径必须是 "markdown.extension.toc.updateOnSave": true，注意前缀是 markdown.extension，不是 markdown.preview

侧边栏大纲空白？三个设置缺一不可

VSCode 自带的侧边栏 Outline 面板才是最轻量、最可靠的标题导航，但它默认不显示，且容易漏配。

• 必须启用 explorer.experimental.showOutline（新版设置里叫 Explorer > Show Outline）
• 同时设 outline.automaticCollapse 为 false，否则大纲会自动折叠成一行
• 当前文件语言模式必须是 markdown（再次强调，右下角要显示这个）
• 若仍为空白，按 Ctrl+Shift+P 输入 Developer: Toggle Developer Tools，看 Console 是否报 Failed to resolve outline provider for 'markdown' ——这说明内置 Markdown 语言服务器没起来，重启或重装 VSCode 内置 Markdown 扩展即可

真正麻烦的不是生成目录，而是搞清「哪里该信、哪里别信」：VSCode 预览窗口的跳转不可靠，侧边栏大纲才真实；updateOnSave 看似智能，实则只做局部刷新；中文锚点问题不是 bug，是不同平台规则打架——你得选边站队，而不是等它自动兼容。