vs code原生markdown预览不自动刷新需同时配置files.autosave（设为onfocuschange或afterdelay）和markdown.preview.autorefresh（true），并重启预览窗口；公式需开启markdown.math.enabled且块级公式前后空行；滚动同步须同时启用scrolleditorwithpreview与scrollpreviewwitheditor。
预览不自动刷新？检查 files.autoSave 和 markdown.preview.autoRefresh
VS Code 原生预览默认只在文件保存后更新，未保存的编辑内容不会触发渲染——这不是 bug，是设计行为。想接近 Typora 式实时反馈，必须组合配置：
-
files.autoSave设为"onFocusChange"或"afterDelay"（避免频繁写盘可选后者） -
markdown.preview.autoRefresh必须为true（默认开启，但远程开发环境或策略组可能重置） - 改完设置后，**关掉再重新打开预览窗口**（
Ctrl+Shift+V），不是重启 VS Code
如果仍不动，确认当前文件后缀是 .md，且 markdown.preview.enabled 未被禁用。
公式不渲染？先看 markdown.math.enabled 和空行规范
KaTeX 公式支持从 VS Code 1.84+ 原生集成，但默认关闭。90% 的“公式显示为纯文本”问题源于此开关未开，而非插件缺失：
- 在
settings.json中设"markdown.math.enabled": true - 块级公式（如
$$E = mc^2$$）前后必须各有一行**完全空白**（不能有空格或注释） - 行内公式用单
$，如$x^2$；混用中文括号或反引号会直接跳过解析 - 若装了
Markdown All in One，它会接管数学设置，此时要改的是markdown.extension.math.enabled
滚动不同步？两个布尔值必须同时为 true
编辑区往下滚、预览卡在顶部，不是插件问题，而是同步机制未激活：
Markdown to PDF Converter (v2.0)
下载
离线Markdown转PDF转换器，基于Pandoc与WeasyPrint，支持完整Unicode及本地表情缓存，可将Markdown转为专业级PDF...
-
markdown.preview.scrollEditorWithPreview和markdown.preview.scrollPreviewWithEditor必须**同时设为true** - 只开一个等于没开——这是最常被忽略的配置对
- 修改后需关闭现有预览窗口，再用
Ctrl+Shift+V或命令面板重新打开
注意：该设置仅对原生预览生效；若使用 Markdown Preview Enhanced，对应参数是 markdown-preview-enhanced.scrollSync。
样式错乱或白屏？markdown.preview.styles 路径必须相对工作区根目录
自定义 CSS 不生效，几乎全是路径问题。VS Code 不报错，只留空白预览：
- 路径写成
./styles/md.css（推荐），不是绝对路径或../styles/ - CSS 文件需放在工作区根目录下可访问的位置，编码必须为 UTF-8
- 若用
Markdown Preview Enhanced，其样式配置项是markdown-preview-enhanced.styles，别和原生设置混淆 - 调试建议：用开发者工具（
Ctrl+Shift+I）检查预览页是否加载了 CSS，以及是否有 404 请求
复杂点在于：不同插件（原生预览 / Markdown Preview Enhanced / Markdown All in One）各自维护一套配置键名，且互不覆盖。混用时务必分清作用域，否则改了 settings.json 却发现根本没生效。
