vs code 中按 ctrl+shift+v(win/linux)或 cmd+shift+v(macos)即可开启内置 markdown 实时预览,需确保文件为 .md 后缀、语言模式为 markdown 且无插件冲突;启用自动刷新需勾选 markdown.preview.autorefresh 设置。

VS Code 里 Markdown 实时预览怎么开
直接按 Ctrl+Shift+V(Windows/Linux)或 Cmd+Shift+V(macOS),就能在右侧弹出预览窗——这是 VS Code 内置功能,不用装插件,但得确保当前文件后缀是 .md,且没被其他插件劫持编辑器行为。
常见错误现象:按了没反应。可能原因有三个:
- 文件没保存,或者后缀不是
.md(比如写成了readme或.markdown) - 当前语言模式被手动切成了
Plain Text(右下角状态栏看,点它可改回Markdown) - 装了冲突插件,比如某些「增强预览」类扩展会禁用原生预览逻辑
预览不自动刷新?检查这几个地方
默认是保存后刷新,不是键入即更新。想边写边看变化,得打开自动更新开关:
- 打开设置(
Ctrl+,),搜markdown.preview.autoRefresh,勾选它 - 注意:这个选项只对「已打开的预览页」生效;如果预览窗口是手动关掉再重开的,要重新触发一次刷新(哪怕只是光标移进预览区)
- 某些主题或字体设置会让预览区渲染变慢,尤其含大量数学公式或 Mermaid 图时,延迟可能达 1–2 秒
性能影响不大,但开启后每次按键都会触发轻量解析,老机器上偶尔卡顿,属于正常现象。
为什么预览里链接点不开、表格错位、代码块没高亮
因为 VS Code 原生预览只支持标准 CommonMark 语法,不兼容部分 GitHub Flavored Markdown(GFM)扩展特性:
-
[link](/path)这种相对路径链接,在预览里是纯文本,不会跳转(本地文件系统限制) - 表格中若用了
colspan或rowspan,会被忽略,按单格处理 - 代码块语言标识如
```ts或```bash能识别,但```mermaid默认不渲染(需额外插件) - 自定义 CSS(比如
<style>...</style>)在预览里完全不生效
想更接近 GitHub 效果,该装哪个插件
推荐 Markdown Preview Github Styling(作者:bierner)。它不替换原生预览,而是给预览加一层 GitHub 风格 CSS,同时保留所有原生功能。
安装后注意两点:
- 必须重启预览窗口(关掉再按
Ctrl+Shift+V),否则样式不加载 - 它不解决 GFM 语法缺失问题(比如任务列表 ✅ 渲染仍依赖 VS Code 版本,1.85+ 才完整支持)
- 如果和
Markdown All in One同时启用,后者快捷键可能覆盖原生Ctrl+Shift+V,建议在后者设置里关掉markdown.extension.preview.autoShowPreviewToSide
真正难搞的是嵌入式内容——比如 iframe、交互图表、本地图片路径带空格或中文——这些在任何预览里都容易挂,别指望一键解决。










