VSCode默认Ctrl+Shift+V预览不更新因其为一次性快照，需开启自动保存并使用Markdown Preview Enhanced扩展实现真正的实时预览，同时合理配置数学公式、图片加载与SVG处理策略。
VSCode默认的Ctrl+Shift+V预览为什么经常不更新？
因为它是“一次性快照”，不是实时监听——只要文件没保存，或者编辑器焦点不在当前MD文件上，预览就不会刷新。尤其在写长文档、频繁插入图片或修改表格时，手动反复按快捷键非常打断节奏。
解决方法只有两个：开启自动保存 + 启用真正的实时预览扩展。别信某些教程说“改设置就能实时”，VSCode原生markdown.preview.autoShowPreviewToSide只控制是否自动弹出面板，不解决刷新逻辑。
- 必须开启
files.autoSave（设为afterDelay或onFocusChange） - 禁用
markdown.preview.doubleClickToSwitchToEditor，否则双击预览区会意外切回编辑器，中断渲染 - 如果用的是Remote-SSH，确保
markdown.preview.useWebview为true，否则本地渲染引擎无法加载远程资源
推荐用Markdown Preview Enhanced而不是Markdown All in One
Markdown All in One主打快捷键和大纲，预览只是附带功能；而Markdown Preview Enhanced（简称MPE）从底层用Pandoc+WebView重构了渲染流程，支持数学公式、PlantUML、Mermaid实时解析，且能响应watch事件自动重绘。
安装后关键配置项：
- 启用
markdown-preview-enhanced.enableExtendedAutosave：让未保存的草稿也能触发预览更新 - 把
markdown-preview-enhanced.previewTheme设为github.css，避免默认主题字体过小或代码块背景发灰 - 若插入本地图片路径含中文，需确认
markdown-preview-enhanced.enableScriptExecution为false，否则脚本沙箱会拦截非ASCII路径
mdmath插件和MathJax冲突导致公式不渲染？
VSCode里同时装了mdmath和Markdown Preview Enhanced，公式可能完全不显示，或只渲染第一次——这是因为两者都试图接管$...$和$$...$$语法，但MathJax初始化时机不同，后者会覆盖前者全局配置。
正确做法是二选一：
- 要LaTeX完整支持（如参考文献、交叉引用）：卸载
mdmath，改用MPE内置的mathjax配置，在settings.json加："markdown-preview-enhanced.mathjaxConfig": { "tex": { "inlineMath": [['$', '$'], ['\(', '\)']], "packages": {'[+]': ['ams', 'color']} } } - 仅需基础行内/块级公式：保留
mdmath，但关闭MPE的数学渲染：markdown-preview-enhanced.enableMath→false
预览窗口卡顿、滚动不同步、图片加载慢怎么办？
本质是WebView资源加载策略问题。VSCode的预览页本质是个精简版Chromium，但默认禁用硬件加速，且对大图不做懒加载。
实测有效的调优项：
- 在
settings.json中添加："markdown-preview-enhanced.enableFileWatching": true, "markdown-preview-enhanced.enableCodeBlockHighlighting": false
（关闭高亮可显著降低CPU占用） - 图片超过2MB建议转WebP格式，并在MD中显式指定宽高：
{width="600px" height="400px"}，否则WebView会先加载全尺寸再缩放，拖慢首屏 - 禁用所有非必要插件（尤其是
Polacode、Bracket Pair Colorizer），它们会向WebView注入额外CSS/JS，引发样式污染
真正麻烦的是嵌入SVG——它会被当作HTML片段直接插入，若含外部<script></script>或复杂滤镜，WebView可能拒绝执行或白屏。这种场景下，不如导出为PDF再查看。
