VSCode配置Markdown实时预览 VSCode写Markdown文档教程
很多朋友刚上手VSCode写Markdown时，可能会有一个误解：它的预览是“实时”的。其实不然，默认情况下，预览只在文件保存后才刷新，并不会监听你正在编辑的内容。想要获得那种丝滑的、边写边看的体验，得靠几个关键配置组合拳来实现，核心就是 files.autoSa ve 和 markdown.preview.autoRefresh 这两个开关，再加上正确的预览打开方式。
Ctrl+Shift+V 没反应？先查这三个地方
遇到快捷键失灵，别急着怪插件。十有八九是下面这三个地方出了问题：
- 首先，得确认
markdown.preview.enabled这个总开关是true。虽然默认是开的，但在一些安全策略或远程开发环境下，它可能被重置了。 - 其次，看看你的文件后缀名。必须是
.md才行，.markdown或者没有后缀的文件，VSCode的预览逻辑可能认不出来。 - 最后，如果你装了Vim、Emacs这类键盘映射插件，它们很可能会“劫持”
Ctrl+Shift+V这个组合键。临时禁用这些插件试试，或者干脆打开命令面板（Ctrl+Shift+P），直接搜索“Markdown: Open Preview to the Side”来打开预览。
为什么改了文字预览不动？不是 bug，是设计
这可能是最让人困惑的一点：明明编辑器里改了，预览窗口却纹丝不动。其实，这不是Bug，而是VSCode的设计逻辑——预览窗口读取的是磁盘上已保存的文件内容，而不是编辑器内存里还没保存的改动。
- 所以，关键动作是 保存。你必须按一下
Ctrl+S，或者启用自动保存功能，才能触发预览更新。 - 而
markdown.preview.autoRefresh这个设置，控制的是“保存后是否自动刷新预览”，默认是开启的。但前提是，文件得先保存过。 - 如果你想追求类似Typora那种近乎实时的体验，可以这么设置：将
files.autoSa ve设为onFocusChange（切换窗口时自动保存）或afterDelay（延迟后自动保存），同时确保markdown.preview.autoRefresh是开启状态。 - 另外，预览窗口右上角那个刷新按钮（↻）的作用是重载HTML，它并不会去读取文件的新内容。如果根本问题（文件未保存）没解决，点它也没用。
数学公式、Mermaid 图表、中文标题链接不生效？检查渲染开关
VSCode的原生预览为了安全和性能，默认关闭了很多扩展渲染能力，需要你手动开启：
- LaTeX公式：需要启用
markdown.math.enabled（VS Code 1.84及以上版本）。这里有个细节：公式块前后必须有空行，像$$E = mc^2$$这样写才会被正确渲染。如果是行内公式（如$E = mc^2$），可能还需要额外开启像 Markdown All in One 插件里的markdown.extension.math.inlineEnabled选项。 - Mermaid图表：原生预览完全不支持。你必须安装专门的
Mermaid Preview插件，或者使用Markdown Preview Enhanced这类增强插件，并在其设置中勾选启用Mermaid。 - 中文标题可点击、裸URL变链接：试试启用
markdown.preview.enableExtendedAutolinks和markdown.preview.enableScripts（后者仅建议在本地可信文档中使用）。 - 样式错乱或白屏：如果自定义了预览样式，检查一下
markdown.preview.styles里填的路径。它要求是相对于工作区根目录的路径，比如["./styles/md-preview.css"]。路径一旦填错，预览可能直接一片空白，而且不会有任何错误提示。
同步滚动、大纲导航、导出 PDF 这些功能容易被忽略
这些提升长文档写作效率的功能，其实VSCode都提供了，但往往藏在设置里，不打开就用不了：
- 同步滚动：需要同时开启两个设置——
markdown.preview.scrollEditorWithPreview和markdown.preview.scrollPreviewWithEditor。只开一个，滚动就是单向的，体验会打折扣。 - 大纲视图（Outline）：这是VSCode的原生功能，不需要额外插件。按
Ctrl+Shift+P打开命令面板，搜索“View: Toggle Outline”就能唤出侧边栏的大纲。 - 导出 PDF/HTML：VSCode本身不提供这个功能。
Markdown Preview Enhanced插件是目前比较稳定的选择。不过要注意操作顺序：必须先打开预览窗口，然后在预览区域右键选择“Export to PDF”，否则可能会因为路径解析失败而导出空白文档。 - 双屏写作：最简单的方案就是直接拖动预览页的标签页到另一个显示器，或者右键标签页选择“Move to New Window”。这个方法比依赖任何插件都更直接可靠。
说到底，阻碍我们顺畅使用Markdown预览的，往往不是功能缺失，而是那些默认关闭的布尔值开关、被习惯性忽略的保存动作，以及像把相对路径写成绝对URL这类看似低级却非常隐蔽的错误。通常，只要调好 files.autoSa ve 和那两个同步滚动的 scroll* 配置，再注意一下公式块前后留空行，90%以上的“预览不工作”问题就迎刃而解了。
