VSCode配置Markdown目录：一键生成侧边栏与文档索引技巧-VSCode-PHP中文网

vscode侧边栏大纲（outline）默认不启用，需手动开启explorer.experimental.showoutline和markdown.preview.toc两项设置才能显示标题结构化导航树。

vscode配置markdown目录：一键生成侧边栏与文档索引技巧

VSCode自带的“大纲”面板就是最轻量的侧边目录，但它不会自动弹出来，也不默认解析所有Markdown文件的标题结构。关键在两个设置是否打开：explorer.experimental.showOutline 和 markdown.preview.toc。

必须手动开启，否则侧边栏永远只显示“EXPLORER”“SEARCH”等常规标签，看不到标题树。

侧边栏大纲只是导航索引，不嵌入文档本身；如果需要把目录写进 .md 文件顶部、支持 GitHub 渲染或导出 HTML，就得生成实际的 Markdown 列表行。

Markdown All in One 是目前最稳定的选择，它不依赖 Pandoc 或外部服务，命令执行快，中文标题锚点转换也可靠（如 ## 中文标题 → [中文标题](#中文标题)）。

光标放在想插入的位置（通常是文件开头或 [toc] 标记处），按 Ctrl+Shift+P 输入 Markdown: Create Table of Contents
生成的链接默认使用 github-slug 规则：空格变-，中文转 URL 编码（如 %E4%B8%AD%E6%96%87），标点被剔除
不支持自动更新——改了标题后，旧目录不会同步变，必须手动再运行一次命令
若想保存时自动重生成，需在插件设置里打开 markdown.extension.toc.autoUpdate

很多人搜“VSCode Markdown 侧边目录”，实际想要的是像 Typora 那样左边固定导航栏、右边滚动内容的效果。VSCode 做不到——它的预览是单页只读视图，没有左侧菜单区。

Web fetch markdown of page

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

下载

真要这种体验，必须起一个本地 HTTP 服务，用 docsify 动态渲染。这不是配置问题，而是架构差异：VSCode 是编辑器，docsify 是浏览器端渲染器。

_sidebar.md 必须和 index.html 同级，且文件名带下划线，否则 docsify 加载失败，控制台报 404 /_sidebar.md
文档里至少要有两个 ## 或更高级别标题，# 一级标题默认不进 TOC
npx docsify serve . 启动后访问 http://localhost:3000，VSCode 只负责编辑，刷新靠浏览器自动完成
别试图用 Live Server 插件打开 index.html——它不加载 _sidebar.md，也不执行 docsify 的 JS 初始化逻辑

同一个中文标题，在不同地方生成的锚点可能完全不同：VSCode 预览、GitHub、docsify、导出的 HTML，各自处理规则不一致。这不是 bug，是规范差异。

例如 ## 数据库连接配置：

VSCode 内置预览用的是 database-connection-configuration（拼音转小写短横）
GitHub 用的是 数据库连接配置（原样 URL 编码，即 %E6%95%B0%E6%8D%AE%E5%BA%93%E8%BF%9E%E6%8E%A5%E9%85%8D%E7%BD%AE）
docsify 默认用 github-slug，行为接近 VSCode，但可配成 gitlab 或 cjk 模式
如果你手写链接如 [跳转](#数据库连接配置)，只在 GitHub 有效；写成 [跳转](#database-connection-configuration)，才在 VSCode 预览和 docsify 里生效

跨平台兼容性要求高的场景，别依赖自动生成的锚点格式，要么统一用英文标题，要么在生成后手动校验跳转目标是否真实存在。