Ctrl+Shift+V无效首要检查三件事:右下角语言模式是否为“Markdown”、文件后缀是否为.md、markdown.preview.enabled是否为true;其次排查快捷键被Vim/输入法劫持;未保存内容不会刷新预览,必须先Ctrl+S保存。

Ctrl+Shift+V 按了却弹不出预览?先确认这三件事
不是预览关不掉,而是根本没触发——VSCode 的 Markdown 预览只对真正被识别为 Markdown 语言模式的 .md 文件生效。
- 右下角状态栏必须显示
Markdown(不是Plain Text或Markdown (GitHub)),按Ctrl+K M可强制切换 - 文件后缀必须是
.md;.markdown、.txt或无后缀都不会激活预览逻辑 -
markdown.preview.enabled必须为true(Remote-SSH 环境下常被重置为false)
快捷键被劫持也很常见:Vim/Emacs 插件、输入法或系统级键盘映射可能吞掉 Ctrl+Shift+V。临时验证方法是用 Ctrl+Shift+P → 输入 Markdown: Open Preview to the Side 手动唤起。
预览窗口打开了但内容不更新?这不是 bug,是设计
VSCode 原生 Markdown 预览只读取磁盘文件,不监听编辑器内存缓冲区。未保存的修改永远不会进入预览流程。
- 必须先按
Ctrl+S保存,预览才刷新——这是硬性前提,无法绕过 -
files.autoSave设为onFocusChange或afterDelay可减少手动保存频次,但不能替代保存动作 -
markdown.preview.autoRefresh默认为true,但它只对已保存文件生效;设为false会导致连保存后也不刷新 - 预览窗口右上角的刷新按钮(↻)只是重载 HTML 渲染层,不会重新读取文件内容
想彻底禁用右侧 Markdown 预览窗口?关两个开关就够了
关闭预览不是关“功能”,而是关“自动唤起行为”。重点在两处设置:
将任意网站转换为文件系统,自动抓取网站并将页面挂载为 Markdown 文件,可使用 grep、diff、cat 等标准 Unix 命令进行搜索、比较、读取和浏览。
-
markdown.preview.enabled设为false:全局禁用预览视图,Ctrl+Shift+V和右键菜单里的预览选项都会消失 -
workbench.editor.enablePreview设为false:防止资源管理器单击.md文件时自动以预览模式打开(标签斜体 + 被覆盖)
这两个配置互不替代:markdown.preview.enabled 控制预览功能是否可用,workbench.editor.enablePreview 控制文件是否以预览方式打开。只关一个,另一个仍可能让你误入预览状态。
预览开着但滚动不同步、锁死不更新?检查这三个隐藏开关
同步滚动和锁定行为默认都是关闭的,容易被当成“bug”:
- 点击预览窗口右上角三个点 → 勾选
Sync Scrolling,或同时启用两个设置:markdown.preview.scrollPreviewWithEditor和markdown.preview.scrollEditorWithPreview(单开一个无效) - 误点预览窗口左上角的锁图标(
Lock Preview to Current Document)后,切换文件时预览不会更新,需手动点击解锁 - 预览窗口本身是只读 WebView,无法编辑;要改内容,必须右键预览标签页 →
Reopen Editor With → Text Editor
最易忽略的是:预览页没有 unsaved changes 标识(没圆点),你改了几行却没注意它仍是预览状态,切走再回来,改动可能被新文件覆盖。










