vscode内置markdown预览需手动触发(ctrl+shift+v/cmd+shift+v),默认保存后刷新,支持标准commonmark;未保存文件、插件冲突或路径错误会导致渲染异常。

VSCode内置预览功能怎么开
VSCode自带的 Markdown 预览是默认启用的,但很多人没注意到它不自动弹出——需要手动触发。按 Ctrl+Shift+V(Windows/Linux)或 Cmd+Shift+V(macOS)即可在右侧打开实时预览窗格;如果已打开,再次按键会刷新内容。
注意:预览只对当前编辑的 .md 文件生效,且文件必须已保存(未保存时部分样式可能不渲染,比如自定义 CSS 或引用本地图片路径)。
为什么修改后预览没自动更新
VSCode 的 Markdown 预览默认是「保存后刷新」,不是「键入即刷新」。这不是 bug,是设计选择——避免频繁重绘影响性能,尤其文档含大量数学公式或图表时。
- 想改完立刻看到效果?保存文件(
Ctrl+S)是最可靠方式 - 确认设置没被关掉:
markdown.preview.autoRefresh应为true(在设置里搜这个配置项) - 如果用了插件如
Markdown Preview Enhanced,它可能接管了预览逻辑,导致原生行为失效
如何让预览支持 Mermaid、LaTeX 或本地图片
原生预览仅支持标准 CommonMark 语法,Mermaid 图表、$...$ 数学公式、 这类相对路径图片默认不渲染。
- Mermaid:需安装官方扩展
Markdown All in One或启用 VSCode 设置markdown.preview.experimental.markdownItPlugins(v1.90+),再配合mermaid-cli或浏览器环境支持 - LaTeX:原生不支持,必须用
Markdown Preview Enhanced插件,并开启enableMathJax - 本地图片路径失败?检查路径是否相对于当前
.md文件,而不是工作区根目录;预览中./指向文件所在目录,不是vscode workspace root
快捷键冲突或预览窗口卡死怎么办
常见于装了多个 Markdown 插件(比如同时启用 Markdown Preview Enhanced 和 Markdown All in One),它们会注册同名命令或劫持 Ctrl+Shift+V。
- 先禁用所有第三方 Markdown 插件,只留 VSCode 自带功能测试
- 查快捷键绑定:打开命令面板(
Ctrl+Shift+P),输入Preferences: Open Keyboard Shortcuts (JSON),搜索markdown.preview看是否有重复映射 - 预览窗格卡住?右键点击预览区域 →
Reopen Preview to the Side,或关闭后重新触发Ctrl+Shift+V
实际用下来,最常被忽略的是「文件未保存」和「插件冲突」这两点。预览不是浏览器标签页,它依赖 VSCode 的解析上下文,路径、插件、甚至编辑器缩放比例都可能影响渲染结果。











