VSCode Markdown预览需手动保存或启用自动保存才刷新,数学公式需开启markdown.preview.math设置,快捷键Ctrl+Shift+V打开预览、Ctrl+K V右侧显示,支持字体与字号配置。

VSCode 自带 Markdown 预览功能,无需插件就能实时查看渲染效果,但默认不自动刷新、不支持数学公式和部分扩展语法——关键在于启用正确配置和知道何时要手动干预。
如何触发并保持 Markdown 实时预览
按 Ctrl+Shift+V(Windows/Linux)或 Cmd+Shift+V(macOS)可打开当前文件的预览面板;再次按键可切换同步滚动。预览页不会自动刷新编辑中的内容,需手动保存(Ctrl+S)或启用自动保存后才更新。
- 开启自动保存:设置中搜索
files.autoSave,设为afterDelay或onFocusChange - 预览窗口右上角有三个按钮:
Open Preview to the Side(并排显示)、Refresh(强制重载)、Open in Browser(用系统浏览器打开) - 若修改后预览无变化,先确认是否已保存,再检查右下角状态栏是否显示
Markdown语言模式(点击可切换)
为什么数学公式(LaTeX)不渲染?
VSCode 内置预览器默认禁用 MathJax,$$E = mc^2$$ 这类行间公式会原样显示为文本。必须手动启用支持:
- 在设置中搜索
markdown.preview.math,勾选它 - 重启预览窗口(关闭再按
Ctrl+Shift+V) - 注意:仅支持标准 LaTeX 语法,不支持自定义命令或宏包;如需完整支持,得换用
Markdown All in One+ 浏览器插件方案
常用但被忽略的预览快捷键与配置项
很多人只记得 Ctrl+Shift+V,却不知道这些能提升效率的细节:
-
Ctrl+K V:在编辑器右侧直接打开预览(比默认居中更方便对照修改) - 右键编辑区 →
Open Preview或Open Preview to the Side - 设置中调整
markdown.preview.fontSize和markdown.preview.fontFamily可优化阅读体验 - 若预览样式异常(比如代码块无高亮),检查是否误启用了
markdown.preview.enabledLanguages并删掉非必要语言
真正卡住人的往往不是“打不开预览”,而是保存了却不刷新、写了公式却没开 math 支持、或者用了 Mermaid 流程图但没配 markdown.mermaid.previewer ——这些开关都藏在设置里,且多数需要重启预览窗口才生效。










