必须同时开启markdown.preview.scrollEditorWithPreview和markdown.preview.scrollPreviewWithEditor两个配置项,缺一不可;仅开其一或使用Ctrl+Shift+V打开底部预览均无法实现双向滚动同步,正确方式是用Ctrl+K V在侧边栏打开并确保右上角显示↔️图标。

VSCode内置Markdown预览同步滚动必须开两个配置项
只打开markdown.preview.scrollEditorWithPreview或只打开markdown.preview.scrollPreviewWithEditor都不行,二者必须同时为true,否则看起来像“开了但没生效”。这个双向绑定是硬性要求,不是可选组合。
- 在设置 UI 中搜索“Scroll Editor with Preview”和“Scroll Preview with Editor”,两个复选框都要勾上
- 如果用
settings.json手动写,必须成对出现:"markdown.preview.scrollEditorWithPreview": true,<br>"markdown.preview.scrollPreviewWithEditor": true
- 改完不用重启,但当前预览标签页需关闭重开(比如按
Ctrl+K V再触发一次)才能加载新配置
Ctrl+K V 是唯一可靠触发并排同步预览的快捷键
Ctrl+Shift+V(或Cmd+Shift+V)打开的是底部嵌入式预览,它不支持同步滚动,也不显示双箭头图标——这不是 bug,是设计如此。真正启用同步滚动的入口只有Ctrl+K V。
- 执行
Ctrl+K V后,VSCode 会强制在右侧侧边栏打开预览,并默认启用双向同步 - 如果没看到右侧预览,大概率是编辑器宽度太窄,拖宽窗口或手动拉出侧边栏即可恢复
- 右上角出现双箭头循环图标(↔️),说明同步已就绪;点它可临时禁用,再点恢复
同步失效的四个隐藏原因
即使配置全对、快捷键正确,同步仍可能静默失效。常见真凶不是设置,而是状态断连:
- 文件未保存:.md 文件处于“未保存”状态(标签名斜体+星号),VSCode 降级为纯文本预览,同步逻辑直接跳过
- 路径含中文或空格:尤其 Windows 下挂载网络盘时,锚点解析失败,可临时复制到
C:\test\类纯英文路径验证 - 预览被刷新:点了预览右上角的?,或按了
F5,Webview 重建,所有事件监听丢失 - 同时存在多个预览标签:比如一边是内置预览,一边是
Markdown Preview Enhanced,系统可能把滚动事件发给错误的那个
想真正稳定同步?换 Markdown Preview Enhanced 插件
原生预览的同步基于标题锚点和行号映射,光标停在无标题段落、表格内部或代码块里时,大概率不跳转。而Markdown Preview Enhanced(MPE)通过 Webview 主动监听光标位置和 DOM 偏移,能实现更细粒度的定位。
- 安装后必须重启 VSCode,否则 Webview 初始化失败,
enableSyncScroll不生效 - 务必用命令面板执行
Markdown Preview Enhanced: Open Preview to the Side,不要拖拽或右键打开 - 检查状态栏右下角是否显示
MPE或KaTeX标识,没有就说明当前预览不是它启动的 - 禁用
workbench.editor.enablePreview,否则预览标签被回收会导致同步中断


















