VSCode Markdown预览不同步问题可通过五步解决：一、启用双向滚动设置；二、用Cmd+K V快捷键强制刷新；三、禁用干扰性第三方扩展；四、重置settings.json中markdown配置；五、切换为侧边预览模式。

如果您在 VSCode 中编辑 Markdown 文件时，发现预览窗口无法实时更新或与编辑器不同步滚动，则可能是由于预览设置未启用、扩展冲突或配置项被意外修改。以下是解决此问题的步骤：

本文运行环境：MacBook Air，macOS Sequoia。

一、启用内置 Markdown 预览同步滚动

VSCode 内置的 Markdown 预览支持双向同步滚动，但需确保相关设置已开启。该功能依赖于 editor.markdown.preview.scrollEditorWithPreview 和 editor.markdown.preview.scrollPreviewWithEditor 两个配置项。

1、按下 Cmd + , 打开设置界面。

2、在搜索栏输入 markdown preview scroll。

3、勾选 Markdown > Preview: Scroll Editor With Preview。

4、勾选 Markdown > Preview: Scroll Preview With Editor。

二、使用快捷键强制刷新预览

当预览内容未响应编辑变更时，可手动触发重新渲染。该操作不更改配置，仅刷新当前预览视图，适用于临时状态异常。

1、将光标置于 Markdown 编辑器中任意位置。

2、按下 Cmd + K V（macOS）或 Ctrl + K V（Windows/Linux）打开预览面板。

3、再次按下相同快捷键，关闭后重新执行一次，可强制重建预览上下文。

三、禁用干扰性 Markdown 扩展

第三方 Markdown 扩展（如 Markdown All in One、Markdown Preview Enhanced）可能覆盖内置预览逻辑，导致同步失效或滚动错位。

1、点击左侧活动栏的 扩展图标（方块拼图）。

2、在搜索框输入 markdown。

3、逐一找到非官方扩展，点击其右侧的齿轮图标，选择 禁用。

4、重启 VSCode 后测试内置预览是否恢复同步滚动。

四、重置用户级 Markdown 配置

用户 settings.json 中若存在覆盖性配置（如 "markdown.preview.breaks": true），可能间接影响滚动行为。清除自定义 Markdown 相关字段可还原默认行为。

1、按下 Cmd + Shift + P 打开命令面板。

2、输入并选择 Preferences: Open Settings (JSON)。

3、查找包含 "markdown." 的行。

4、将整行（包括逗号）删除，保存文件。

五、切换预览模式为侧边预览

内联预览（Inline Preview）在部分布局下会限制滚动同步精度，而侧边预览（Side Preview）使用独立 WebView 实例，稳定性更高。

1、右键编辑器标签页中的 .md 文件。

2、选择 Open Preview to the Side。

3、确认预览窗口出现在右侧，并测试编辑时的滚动联动效果。