VS Code Markdown 预览怎样同步定位当前标题

在 VS Code 里编辑 Markdown 时，最省事的做法是把预览打开到编辑器侧边。内置预览会把源码滚动位置和渲染后的内容关联起来：滚动 Markdown 源码，预览跟着移动；滚动预览，编辑器也会定位到相近的源码位置。要从预览回到某个标题附近，直接双击预览中的元素即可。

官方地址：https://code.visualstudio.com/

打开一个 .md 文件后执行“Markdown: Open Preview to the Side”，先确认两侧显示的是同一个文件；随后在任一侧滚动，观察另一侧是否跟随。若阅读预览时不想被另一侧带动，再分别关闭两个滚动同步设置。

打开 Markdown 预览到编辑器侧边

先准备一个有多个二级、三级标题的 Markdown 文件，这样滚动同步更容易观察。打开文件后按下 Ctrl+K V（macOS 为 ⌘K V），或者打开命令面板，运行 Markdown: Open Preview to the Side。左侧保留 Markdown 源码，右侧出现渲染后的预览。

如果只看到一个普通预览标签页，说明预览没有以侧边方式打开。可以关闭当前预览，再重复“Open Preview to the Side”；也可以在编辑器标签页上右键，选择“Open Preview to the Side”。

编辑器和预览怎样双向跟随

侧边预览打开后，先做两个简单动作：

1. 在左侧源码中把光标放到靠后的标题或段落，观察右侧是否滚动到对应内容。
2. 拖动右侧预览的滚动条，观察左侧是否移动到相近的 Markdown 源码区域。

这里的“相近”不是把每一行源码机械地映射成一行预览。Markdown 标题、列表、代码块和段落渲染后高度不同，所以 VS Code 会按内容位置进行同步。标题越清晰、文档结构越规整，定位感越稳定。

如果两侧完全不动，先确认右侧确实是当前文件的 Markdown Preview，而不是 Markdown Editor 或某个扩展提供的自定义预览。再检查预览是否被锁定，以及当前文件是否已经保存到正确的工作区。

用当前行标记和双击动作定位标题

当源码很长时，不必反复拖动滚动条。把光标放在标题行，预览左边会出现对应的浅色位置标记，帮助你判断当前源码落在渲染文档的哪个段落附近。这个标记适合从源码定位到预览。

反过来阅读预览时，直接双击某个标题、段落或列表元素，VS Code 会打开对应 Markdown 文件，并把编辑器滚动到相近的源码行。对于层级复杂的文档，建议给标题使用稳定的层级关系，不要用一大段加粗文字代替标题，否则预览侧不容易形成明确的定位锚点。

可以用下面这份最小 Markdown 作为定位练习：

# 发布说明

## 准备工作

先确认工作区和文档结构。

### 检查预览

打开侧边预览后，从这里向下滚动。

## 常见问题

记录同步方向和预览锁定状态。

按需关闭一个同步方向

双向同步适合编辑和校对，但在长文阅读、对照代码或演示时，滚动一侧可能会带动另一侧，反而打断视线。VS Code 提供两个独立设置：一个控制“编辑器滚动时是否带动预览”，另一个控制“预览滚动时是否带动编辑器”。

打开设置搜索 markdown.preview.scroll，就能看到这两个选项。也可以直接编辑工作区的 settings.json。下面是 JSONC 示例，注释说明了每个开关的方向：

{
  // 源码滚动时是否让 Markdown 预览跟随
  "markdown.preview.scrollPreviewWithEditor": true,

  // 预览滚动时是否让 Markdown 编辑器跟随
  "markdown.preview.scrollEditorWithPreview": false
}

上面的组合表示：编辑器仍然可以带动预览，但单独滚动预览时不再拉动源码。若需要完全独立的两个窗格，把两个值都设为 false；若要恢复默认的双向跟随，则都设为 true。保存设置后回到 Markdown 预览，重新滚动一次即可观察变化。

预览锁定时怎样避免跟错文件

Markdown 预览默认会跟随当前激活的 Markdown 文件。如果你切换编辑器标签页后，右侧仍想继续查看原来的文档，可以运行 Markdown: Toggle Preview Locking 锁定预览。锁定后，预览标签标题会显示 [Preview]，它不会因为当前编辑器切换而自动改成另一份文件。

锁定适合做文档对照，不适合用来判断“当前标题为什么没有定位”。排查时先看预览标签是否带有锁定标记；如果带有，先解除锁定，再重新打开当前文件的侧边预览。否则你可能一直在滚动 A 文件的源码，却观察 B 文件的预览。

常见问题速查

小结

VS Code Markdown 预览的定位关键有三点：用“Open Preview to the Side”让源码和预览并排；利用双向滚动、当前行标记和双击元素在两侧切换；当自动跟随影响阅读时，分别调整两个 markdown.preview.scroll... 设置。遇到内容错位，先排除预览锁定和文件对象不一致，再调整同步方向。

相关问题

VS Code 怎样只打开 Markdown 预览而不拆分编辑器？
运行 Markdown: Open Preview 即可在当前编辑器区域打开预览；需要源码和预览并排时再选择 Markdown: Open Preview to the Side。

Markdown 预览能不能固定显示某个文件？
可以在 Markdown 预览处运行 Markdown: Toggle Preview Locking。锁定后切换编辑器标签，预览仍保留原文件。

为什么源码和预览的滚动位置不完全一样？
渲染后的标题、列表、代码块高度与源码行数不同，同步是按内容位置匹配，不是逐行一一对应。优先用标题结构和预览双击定位，不要把滚动条刻度当成严格行号。