Ctrl+Shift+V(Windows/Linux)或Cmd+Shift+V(macOS)是VSCode当前稳定版标准Markdown预览快捷键,但无响应主因是markdown.preview.enabled为false、文件后缀非.md/.markdown或语言模式未设为“Markdown”,且预览不实时更新系设计使然,须保存后才刷新。

Ctrl+Shift+V(Windows/Linux)或 Cmd+Shift+V(macOS)是当前稳定版 VSCode 的标准快捷键,但按了没反应、开了不更新、点了链接跳不动——这些都不是快捷键本身的问题,而是配置、状态或预期偏差导致的。
Ctrl+Shift+V 按下没反应?先查这三件事
VSCode 不会“突然失灵”,它只是严格按条件执行。常见静默失败原因如下:
-
markdown.preview.enabled被设为false:Remote-SSH 连接后常被重置,打开设置搜这个配置项确认是否为true - 当前文件后缀不是
.md或.markdown:右下角状态栏语言模式必须显示 “Markdown”,若显示 “Plain Text” 或 “Markdown (GitHub)”,点击它手动切回标准 Markdown - 键盘映射插件劫持了快捷键:Vim、Emacs、ThunderHawk 等插件常把
Ctrl+Shift+V绑定为粘贴或其它操作;临时禁用插件再试,或改用命令面板:Ctrl+Shift+P→ 输入Markdown: Open Preview to the Side
预览打开了,但改完内容不刷新?根本就不是实时机制
VSCode 原生预览只读磁盘文件,不监听编辑器内存缓冲区。未保存的修改永远进不了预览流程。
- 必须先按
Ctrl+S保存,预览才更新——这是设计,不是 bug -
files.autoSave设为onFocusChange或afterDelay可缓解,但不能绕过“保存即刷新”前提 -
markdown.preview.autoRefresh默认为true,但它只对已保存文件生效;设为false会导致连保存后也不刷新 - 预览窗口右上角的刷新按钮(↻)只是重载 HTML 渲染层,不重新读取文件内容——它解决不了“没保存”这个前提问题
数学公式、Mermaid 图表、中文标题链接为啥不渲染?
原生预览默认禁用扩展语法,LaTeX 和 Mermaid 不是“装了插件就能用”,而是要显式启用对应开关。
- LaTeX 公式:
markdown.math.enabled必须为true(VS Code ≥1.84),块级公式$$...$$前后需有空行;行内公式$E = mc^2$若装了 Markdown All in One,还需开启markdown.extension.math.inlineEnabled - Mermaid 图表:原生预览完全不支持;必须安装
Mermaid Preview插件,或使用Markdown Preview Enhanced并在设置中开启markdown-preview-enhanced.enableMermaid - 中文标题链接失效:检查
markdown.preview.enableExtendedAutolinks是否为true,否则中文标题不会自动生成锚点 ID
同步滚动、双屏写作、样式定制这些功能容易被忽略
它们不依赖插件,但默认关闭——关着就等于白瞎预览窗口。
- 同步滚动:预览窗口右上角三个点 → 勾选 “Sync Scrolling”;或设置中开启
markdown.preview.scrollPreviewWithEditor和markdown.preview.scrollEditorWithPreview - 锁定预览位置:右键预览标签页 → “Keep Preview” 可防止切换文件时预览自动关闭
- 自定义 CSS:在用户设置里添加
markdown.styles数组,填入本地 CSS 路径(如["./styles/custom.css"]),注意路径是相对于工作区根目录
真正容易被卡住的点,往往不在快捷键本身,而在“以为它该实时,其实它只认保存”“以为它默认支持 Mermaid,其实得手动开开关”“以为右下角语言模式没问题,其实点开一看是 Plain Text”。这些细节不报错、不提示,只安静地让预览看起来‘坏了’。


















