ctrl+shift+v没反应需先确认三件事:markdown.preview.enabled为true、文件后缀为.md且语言模式显示“markdown”、无vim/emacs等插件劫持快捷键;原生预览不实时是设计使然,仅保存后刷新。

Ctrl+Shift+V 按了没反应?先确认这三件事
VSCode 当前稳定版(2026 年主流版本)的 Markdown 预览快捷键是 Ctrl+Shift+V(Windows/Linux)或 Cmd+Shift+V(macOS),不是 Ctrl+K V——后者在 ≤1.85 版本中可用,现已弃用,按了无响应属正常。
-
markdown.preview.enabled必须为true(默认开启,但 Remote-SSH 环境下可能被重置) - 当前文件后缀必须是
.md;右下角状态栏语言模式必须显示 “Markdown”,不是 “Plain Text” 或 “Markdown (GitHub)” - 键盘映射插件(如 Vim、Emacs 模式)常劫持
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 图表不渲染?原生支持需手动开开关
VSCode 内置预览默认禁用扩展语法,LaTeX 和 Mermaid 不是“装了就能用”,而是要显式启用对应配置项。
- LaTeX 公式:启用
markdown.math.enabled(VS Code ≥1.84),且块级公式$$...$$前后必须有空行;行内公式$E = mc^2$需额外开启markdown.extension.math.inlineEnabled(若装了 Markdown All in One) - Mermaid 图表:原生预览完全不支持;必须安装
Mermaid Preview插件,或使用Markdown Preview Enhanced并在设置中开启markdown-preview-enhanced.enableMermaid - 中文标题链接失效?检查
markdown.preview.enableExtendedAutolinks是否为true
同步滚动、双屏写作、样式定制这些功能容易被忽略
它们不依赖插件,但默认关闭——关着就等于白瞎预览窗口。
- 同步滚动:预览窗口右上角三个点 → 勾选 “Sync Scrolling”;或在设置中开启
markdown.preview.scrollPreviewWithEditor和markdown.preview.scrollEditorWithPreview - 双屏写作:拖动 .md 文件标签到另一显示器,或右键标签 → “Move to New Window”,一个窗口写,一个窗口预览
- 自定义样式:在工作区根目录放
styles/md-preview.css,然后设置markdown.preview.styles为["./styles/md-preview.css"];路径错则预览空白,且无任何报错提示
markdown.preview.useWebview 必须为 true,否则远程路径的图片和 CSS 加载失败。











