VSCode 的 GitHub Theme 对 Markdown 预览无效，因其仅控制编辑器和工作台配色；预览样式由内置 CSS、markdown.styles 自定义路径或扩展决定，需手动引入 github-markdown.css 才能复现 GitHub 网站渲染效果。
VSCode 的 Markdown 预览样式“素”，不是因为主题没生效，而是 GitHub Theme 默认**不接管 Markdown 预览的 CSS 渲染**——它只控制编辑器语法高亮和工作台（侧边栏、状态栏等）配色，预览窗用的是 VSCode 自带的、与 GitHub 网站无关的一套静态样式。
GitHub Theme 对 Markdown 预览完全无效
这是最常被误解的一点。很多人装完 GitHub Light 或 GitHub Dark 后打开 README.md，发现预览区还是灰白底+蓝链接，以为主题装错了。其实没错：workbench.colorTheme 只影响 UI 和编辑器，不影响 markdown.preview 的样式链。
VSCode 的 Markdown 预览使用独立的 HTML/CSS 沙箱，其样式由以下三者决定：
- VSCode 内置的默认预览 CSS（硬编码，不可覆盖）
- 用户通过
markdown.styles指定的自定义 CSS 文件（需手动配置） - 扩展（如
Markdown Preview Enhanced）提供的替代渲染器
想让预览接近 GitHub 网站？得手动注入 CSS
官方 GitHub Theme 扩展本身不提供预览样式文件，但你可以复用它的设计逻辑。GitHub 网站的 Markdown 渲染 CSS 开源在 github-markdown-css 仓库。实操步骤如下：
- 下载
github-markdown.css文件（推荐用curl -o github-markdown.css https://raw.githubusercontent.com/sindresorhus/github-markdown-css/main/github-markdown.css） - 保存到项目根目录或全局位置（如
~/css/github-markdown.css） - 在
settings.json中添加："markdown.styles": ["./github-markdown.css"]
（相对路径）或"markdown.styles": ["file:///Users/you/css/github-markdown.css"]
（绝对路径，注意用正斜杠且需file://前缀） - 重启预览窗口（关闭再打开
README.md的预览标签）
⚠️ 注意：markdown.styles 不支持直接写 GitHub 主题扩展里的内置路径，也不能用 ~ 符号；Windows 用户务必把反斜杠 \ 全部换成 /，否则加载失败且无提示。
为什么不用 Markdown Preview Enhanced 这类扩展？
它确实能一键启用 GitHub 样式，但会带来两个真实代价：
- 预览响应变慢：每次渲染都走 Node.js 服务 + 本地 Webview，比原生预览卡顿明显，尤其在含大量图片或数学公式的文档中
- 样式冲突风险：它会覆盖 VSCode 原生的代码块高亮逻辑，导致
```js块里的语法着色和你编辑器里看到的不一致——而 GitHub Theme 的核心价值恰恰是保持编辑/预览语义一致
所以除非你重度依赖 Mermaid 图表或 PDF 导出，否则原生预览 + 手动注入 github-markdown.css 是更轻量、更可控的选择。
真正容易被忽略的点是：markdown.styles 路径一旦写错，VSCode 不报错也不警告，只是静默回退到默认样式——你得主动检查开发者工具（Ctrl+Shift+I → Console）里有没有 Failed to load resource 提示，才能确认是不是路径问题。
