Ctrl+Shift+V 无反应需先确认三件事:markdown.preview.enabled 为 true、文件后缀为 .md、文件已保存;原生预览不实时是设计使然,需配合 autoSave 和 autoRefresh 实现;推荐用 Markdown Preview Enhanced 替代 All in One。

Ctrl+Shift+V 按下没反应?先确认这三件事
VSCode 默认预览根本不会响应未保存的 .md 文件,也不是所有快捷键都生效。别急着装插件,先排查基础条件是否满足:
-
markdown.preview.enabled必须为true(默认开启,但 Remote-SSH 或某些安全策略可能关掉) - 当前文件后缀必须是
.md——.markdown、.txt或无后缀都不会触发预览逻辑 - 文件必须已保存(编辑器标签右上角没有圆点),否则 VSCode 只读磁盘内容,不监听编辑缓冲区
如果用了 Vim 或 Emacs 插件,Ctrl+Shift+V 很可能被劫持;临时禁用再试,或改用命令面板:Ctrl+Shift+P → 输入 Markdown: Open Preview to the Side。
原生预览“不实时”是设计使然,不是 bug
VSCode 原生预览(Ctrl+Shift+V)本质是快照式渲染:只在文件保存后刷新一次,不监听编辑变化。所谓“实时”,必须靠配置组合实现:
- 开启
files.autoSave,设为afterDelay或onFocusChange(别用off) - 启用
markdown.preview.autoRefresh(VS Code 1.84+ 支持,旧版无效) - 右上角那个
↻刷新按钮只重载 HTML,不读新内容——它解决不了“没保存”这个前提
即使全开,公式、Mermaid、脚本仍默认禁用,它们属于扩展能力,不是预览本身的功能。
要真正实时,推荐 Markdown Preview Enhanced 而不是 All in One
Markdown All in One 主打快捷键和大纲,预览只是附带;而 markdown-preview-enhanced 从底层用 WebView + Pandoc 重构流程,能响应编辑变化并自动重绘:
- 安装后必须重启 VS Code,否则快捷键不生效(
Ctrl+K V才是它的侧边预览) - 关键配置项:
markdown-preview-enhanced.enableExtendedAutosave设为true,让未保存草稿也能触发更新 - 若插入本地图片路径含中文,务必关闭
markdown-preview-enhanced.enableScriptExecution,否则沙箱会拦截非 ASCII 路径 - 同时装了
mdmath和 MPE?公式大概率不渲染——两者冲突接管$$语法,卸载mdmath即可
同步滚动、公式、Mermaid 这些功能不会自动开
它们不是“装了插件就自动好”,而是依赖独立开关,且容易被忽略:
- 双向滚动需同时开启:
markdown.preview.scrollEditorWithPreview和markdown.preview.scrollPreviewWithEditor(只开一个等于没开) - 数学公式:原生 KaTeX 需
markdown.math.enabled为true,且块级公式前后必须空行;行内公式$E = mc^2$在Markdown All in One下还需markdown.extension.math.inlineEnabled - Mermaid 渲染:原生预览完全不支持;若用 MPE,检查
markdown-preview-enhanced.mermaidEnabled是否为true;若用原生预览,则必须装Markdown Preview Mermaid Support插件,其他 Mermaid 类插件无效
最常被漏掉的是:改完 settings.json 后没重启预览窗口——关掉已有预览页,再按快捷键重新打开,否则旧配置不生效。


















