vscode内置markdown预览非实时，仅保存后刷新，不支持mermaid、latex及本地图片相对路径渲染；需启用markdown.preview.enabled、确保文件为.md后缀、排查快捷键冲突，配合files.autosave和同步滚动配置方可实现近实时体验。

VSCode 内置的 Markdown 预览不是“实时”的——它只在保存后刷新，且不支持 Mermaid、LaTeX、本地图片相对路径渲染。真·边写边看，必须组合插件或调关键配置。

Ctrl+Shift+V 没反应？先查这三件事

快捷键失效几乎从不因为功能被删，而是被覆盖或前提不满足：

• markdown.preview.enabled 必须为 true（设置里搜这个项确认）
• 当前文件后缀必须是 .md 或 .markdown，.txt 或无后缀不会触发预览逻辑
• 键盘映射类插件（如 Vim、Emacs 模式）常劫持 Ctrl+Shift+V；临时禁用它们再试，或改用右键菜单：编辑区右键 → Open Preview to the Side

改完文字预览不动？不是 bug，是默认行为

VSCode 原生预览不监听输入事件，只响应「文件保存」和「窗口焦点变化」。所谓“自动刷新”仅对已保存文件生效：

Markdown to PDF (Styled)

使用pandoc和wkhtmltopdf将Markdown文件转换为带样式的PDF，支持内置或自定义CSS样式。

下载

• 确保 files.autoSave 设为 onFocusChange 或 afterDelay，否则 Ctrl+S 是唯一可靠触发点
• markdown.preview.autoRefresh 默认 true，但它不等于“键入即刷新”，只是让保存后预览自动重载
• 未保存的 .md 文件也能预览，但本地图片（如 ![a](./img.png)）、自定义 CSS 等依赖文件系统路径的功能会失效

Mermaid 图表/数学公式不渲染？原生不支持，别硬配

CommonMark 标准之外的语法，VSCode 内置预览一律忽略。强行启用 markdown.preview.experimental.markdownItPlugins 也只起部分作用，且不稳定：

• Mermaid：需装 Markdown All in One 并开启 markdown.extension.mermaid.previews，或换用 Markdown Preview Enhanced
• LaTeX：$$E = mc^2$$ 在原生预览中纯文本显示；必须用 Markdown Preview Enhanced + 启用 Enable Math Typesetting，它才调用 KaTeX/MathJax
• 本地图片路径失败？记住：./ 指向的是 .md 文件所在目录，不是 VSCode 工作区根目录；路径错一个层级，预览就空白，且控制台无报错

双屏写作时预览不同步？同步滚动开关藏得深

默认情况下，编辑器滚动不会带动预览窗，反之亦然。要实现 Typora 式联动，必须手动打开两个开关：

• 设置中搜索 markdown.preview.scrollPreviewWithEditor → 设为 true
• 同时搜索 markdown.preview.scrollEditorWithPreview → 也设为 true
• 这两个选项独立控制，只开一个等于白配；它们只对已打开的预览窗生效，新开预览需重新触发

最常被忽略的其实是「插件冲突」：比如同时启用 Markdown Preview Enhanced 和 Markdown All in One，后者可能接管 Ctrl+Shift+V 命令，却只渲染基础语法，让你误以为 Mermaid 失效——实际是命令根本没发给正确插件。