Ctrl+Shift+V没反应因文件未被识别为Markdown、后缀非.md或markdown.preview.enabled为false；Mermaid需装vscode-markdown-mermaid插件并用`mermaid语法；双视图同步需开启两个scroll设置。
Ctrl+Shift+V 为什么有时没反应？先查这三件事
不是插件没装，而是 VSCode 根本没把当前文件当 Markdown 处理。Ctrl+Shift+V 只对已识别为 Markdown 语言模式的 .md 文件生效。
- 右下角状态栏必须显示
Markdown（不是Plain Text；按Ctrl+K M可手动切换） - 文件后缀必须是
.md（.markdown或无后缀不会触发预览） -
markdown.preview.enabled设置项必须为true（某些远程开发环境或安全策略会默认关掉）
快捷键被吞也很常见：Vim 插件、输入法、键盘映射工具都可能劫持 Ctrl+Shift+V。临时验证方法是用 Ctrl+Shift+P → 输入 Markdown: Open Preview to the Side 手动唤起。
Mermaid 图表不渲染？确认插件与代码块语法是否匹配
VSCode 原生预览不支持 Mermaid；必须装插件，且要区分两个主流方案：vscode-markdown-mermaid 和 Markdown Preview Enhanced。前者轻量专注图表，后者功能全但更重。
- 确保安装的是
vscode-markdown-mermaid（官方维护，更新及时），不是名字相近的旧版或 fork 版 - Mermaid 代码块必须用标准语法：
```mermaid开头，```结尾，中间不能有多余空行或缩进 - 预览只在保存后触发——哪怕你开了
files.autoSave，也要等文件真正写入磁盘才解析
常见错误：```mmd 或 ```graph 不会被识别；```mermaid 写成 ```Mermaid（大小写敏感）；代码块外多了一个空格导致解析失败。
双视图同步滚动和快速跳转，靠的是这两个设置
编辑器和预览面板“不同步”，本质是默认关闭了联动逻辑。不需要插件，改两处设置就能让源码和渲染效果真正对齐。
-
markdown.preview.scrollEditorWithPreview设为true：预览滚动时，编辑器自动定位到对应段落 -
markdown.preview.scrollPreviewWithEditor设为true：编辑器光标移动时，预览自动滚到对应位置（尤其对长文档和 Mermaid 图表有效）
注意：vscode-markdown-mermaid 还额外支持双击图表节点 → 自动跳转到源码中该节点定义处，前提是代码块内节点 ID 唯一且未被注释掉。
图表缩放和平移操作，别只依赖鼠标滚轮
大型 Mermaid 图表常超出预览窗口，仅靠鼠标滚轮容易失控。真正高效的操作组合是：
- 缩放：按住
Ctrl（macOS 是Cmd） ++或-，比滚轮更精准；Ctrl+0一键重置 - 平移：按住鼠标左键拖拽图表（不是拖拽预览窗口边框）；方向键微调视图位置
- 定位：双击任意节点，图表自动居中显示该节点；右键菜单里有
Fit to Window和Center on Selection
这些操作只在图表渲染完成后生效——如果预览空白，先检查 Mermaid 语法是否有误（比如漏了 end、用了不支持的关键词），错误信息会显示在 VSCode 底部状态栏，而不是控制台里。
Mermaid 实时预览真正的瓶颈不在渲染速度，而在「保存→解析→渲染」这个链路是否被意外打断。最常被忽略的是：工作区根目录下没有 node_modules 时，某些插件会静默降级为简化模式，连基础流程图都不渲染。遇到怪异现象，先关掉所有非必要插件，再逐个启用排查。
