VSCode Markdown预览默认不实时更新，需启用“Preview: Auto Show Preview To Side”设置才能实现侧边自动预览和近实时同步。
Markdown预览默认不实时更新？改用 markdown.preview.autoShowPreviewToSide
VSCode 内置的 Markdown 预览默认是「手动触发」的：按 Ctrl+Shift+V（Windows/Linux）或 Cmd+Shift+V（macOS）才打开，且不会随编辑自动刷新。要实现「边写边看」，必须启用侧边自动预览模式。
操作路径：Settings → Features → Markdown → Preview: Auto Show Preview To Side，勾选它。此时每次新建或聚焦一个 .md 文件，右侧会自动弹出预览窗；光标在编辑器中移动、输入文字，预览内容几乎实时同步（延迟通常
- 该设置本质是把
markdown.preview.autoShowPreviewToSide设为true，你也可以直接在settings.json中添加这一行 - 如果已打开预览但没自动更新，检查是否误启用了
markdown.preview.doubleClickToSwitchToEditor并双击了预览区——这会让焦点切回编辑器，导致后续输入不触发刷新 - 不建议同时开启
markdown.preview.scrollPreviewWithEditor和scrollEditorWithPreview，两者叠加易造成滚动抖动，尤其文档超长时
想改字体/颜色/行宽？用 markdown.styles 注入自定义 CSS
VSCode 不提供图形化样式配置，但支持通过 markdown.styles 指定本地 CSS 文件路径，从而完全接管渲染样式。这是最稳定、兼容性最好的自定义方式。
步骤很简单：
- 在工作区根目录（或用户 home 目录）新建一个
markdown-styles.css文件 - 在
settings.json中添加："markdown.styles": ["./markdown-styles.css"]
（路径支持相对、绝对，也支持file://协议） - 重启预览窗口（关闭再打开，或按
Ctrl+R刷新）即可生效
注意：CSS 选择器需针对 VSCode 内置的预览 DOM 结构，例如：
body {
font-family: -apple-system, "Segoe UI", "PingFang SC", "Hiragino Sans GB";
line-height: 1.6;
max-width: 820px;
margin: 0 auto;
padding: 24px;
}
code {
background-color: #f5f5f5;
border-radius: 3px;
padding: 2px 4px;
}
别用 !important 覆盖太多，VSCode 后续更新可能调整内部 class 名，导致样式失效。
数学公式不渲染？确认已启用 markdown.math.enabled
VSCode 1.84+ 内置了 KaTeX 支持，但默认关闭。若你写了 $$E = mc^2$$ 却只看到原样文本，大概率是这个开关没开。
- 打开设置，搜索
markdown.math.enabled，勾选启用 - 对应
settings.json条目："markdown.math.enabled": true
- 公式语法必须严格：行内用
$...$，独立块用$$...$$或\[...\]；中间不能有空格或换行 - 不支持 LaTeX 宏定义（如
\newcommand），也不支持复杂包（如amsmath），纯 KaTeX 核心语法
插件冲突导致预览异常？优先禁用非必要 Markdown 插件
VSCode 自带 Markdown 支持已足够健壮，但很多用户装了 Markdown All in One、Markdown Preview Enhanced 等插件，反而引发问题：预览空白、样式错乱、右键菜单重复、快捷键冲突。
排查建议：
- 先禁用所有第三方 Markdown 插件，仅保留 VSCode 内置功能，测试预览是否正常
- 若恢复，则逐个启用插件，定位冲突源；常见冲突点是
markdown.preview.useWebview设置被插件覆盖 -
Markdown Preview Enhanced会劫持Ctrl+Shift+V，并默认使用自己的 WebView 渲染器，与内置预览互斥 - 如确需增强功能（如导出 PDF），建议只在需要时临时启用插件，日常写作保持原生预览
自定义样式和数学公式都依赖于 VSCode 内置预览器的行为一致性，插件介入越少，越容易预测和调试。
