vscode markdown预览快捷键ctrl+shift+v(win/linux)或cmd+shift+v(macos)无反应,主因是:光标未在已打开的.md文件内容区、输入法非英文、markdown.preview.enabled为false、文件后缀非.md、或被vim/emacs等插件劫持。

VSCode 里 Markdown 预览默认快捷键是 Ctrl+Shift+V(Windows/Linux)或 Cmd+Shift+V(macOS),不是 Ctrl+K V,后者是旧版弃用快捷键,按了没反应属正常。
为什么按了 Ctrl+Shift+V 没反应?
这不是预览功能坏了,而是触发前提没满足:
- 光标必须落在已打开的
.md文件内容区域内——不能在空白标签页、文件树、终端或未激活编辑器中 - 输入法必须是英文状态——中文输入法下几乎所有 VSCode 快捷键都会失效
-
markdown.preview.enabled设置值必须为true(默认开启,但某些远程开发环境或策略组可能禁用) - 当前文件后缀名严格为
.md;.markdown、.mdx或无后缀不会匹配内置预览逻辑 - 有 Vim/Emacs 插件时,
Ctrl+Shift+V常被重映射为“粘贴并缩进”等操作,可临时禁用插件验证
怎么让双屏写作真正同步滚动?
默认不联动,必须手动开两个开关,缺一不可:
- 设置搜索
markdown.preview.scrollPreviewWithEditor→ 设为true - 设置搜索
markdown.preview.scrollEditorWithPreview→ 同样设为true
注意:这两个设置只对「已打开的预览窗口」生效。如果预览窗是新打开的,需先执行一次滚动(哪怕只是滚一格),再点一下编辑器,联动才会建立。另外,右上角预览区的「同步滚动」按钮(三个点 → “Sync Scrolling”)只是 UI 开关,底层仍依赖上述两个配置项。
预览不更新?别怪快捷键,先看这三件事
VSCode 预览本质是“磁盘快照”,不是内存监听:
- 未保存的修改不会触发刷新——必须按
Ctrl+S,或设files.autoSave为onFocusChange或afterDelay -
markdown.preview.autoRefresh控制的是“保存后是否自动重载”,不是“边打字边渲染”;设为false就算保存了也不刷新 - 右上角的↻刷新按钮只重新解析 HTML,不读取新内容——它解决不了“没保存”这个根本问题
双屏物理分屏比侧边预览更稳
把一个 .md 文件拖到另一个显示器,或右键标签页 → Move to New Window,再在新窗口里按 Ctrl+Shift+V 打开预览。这样两屏独立进程,避免侧边预览因编辑器布局收缩/折叠导致渲染错位或样式丢失。尤其当文档含 Mermaid 图表或数学公式时,物理双屏能绕过 VSCode 视图容器的尺寸计算 bug——比如预览区高度被错误设为 0px 导致白屏。











