VSCode默认不自动渲染Markdown预览，需手动触发：用Ctrl+Shift+V（Win/Linux）或Cmd+Shift+V（macOS）唤出预览，或右键选“Open Preview to the Side”；中文乱码或样式错乱多因安全策略限制，需设"markdown.preview.enableScripts": true并开启"math.enabled"；同步滚动需启用"Markdown: Sync Scroll"且仅在侧边预览生效；导出HTML/PDF须借助Markdown Preview Enhanced扩展，且需先打开预览窗口。
VSCode 打开 .md 文件后不渲染预览？
默认情况下 VSCode 不自动显示 Markdown 预览，得手动触发。不是插件没装好，也不是文件有问题，只是它压根不会“自动弹窗”。
实操建议：
- 确保文件后缀是
.md（不是.markdown或无后缀） - 用快捷键
Ctrl+Shift+V（Windows/Linux）或Cmd+Shift+V（macOS）唤出实时预览面板 - 右键编辑区 → 选
Open Preview to the Side，比快捷键更稳，尤其在分屏时 - 如果快捷键无效，检查是否被终端、Git 插件或其他扩展劫持了 —— 在命令面板（
Ctrl+Shift+P）里搜Markdown: Open Preview直接运行
预览里中文标题乱码或样式错乱？
不是编码问题，大概率是 VSCode 默认禁用了部分 HTML 渲染能力，尤其涉及自定义 CSS、脚本或某些扩展语法（如 Mermaid、数学公式）时。
实操建议：
- 确认没有启用
"markdown.preview.security": "strict"（该设置会拦截所有内联样式和脚本） - 在设置里搜
markdown.preview.enableScripts，设为true才能跑 Mermaid 或 KaTeX - 数学公式需额外安装
KaTeX支持：在设置中开启"markdown.math.enabled"，并确保文档里用$$...$$或\( ... \)包裹公式 - Mermaid 图表要加
mermaid语言标识：graph LR\nA --> B
想边写边看右侧同步滚动？
VSCode 的预览默认不跟随编辑器光标，也不自动同步滚动，这是设计使然，不是 bug。
实操建议：
- 打开预览后，按
Ctrl+K Ctrl+S（Windows/Linux）或Cmd+K Cmd+S（macOS）打开快捷键设置，搜索sync scroll - 启用
Markdown: Sync Scroll，它会让编辑器和预览窗口滚动位置保持一致 - 注意：该功能只在“侧边预览”（
Open Preview to the Side）下生效，全屏预览不支持 - 如果滚动仍不同步，检查是否启用了
"editor.wordWrap": "on"—— 自动换行可能干扰锚点定位
导出 HTML 或 PDF 总是缺样式？
VSCode 自带的预览只是“看”，不是“导出工具”。直接另存为 HTML 会丢掉所有样式，PDF 更是完全不支持原生导出。
实操建议：
- 别依赖右键菜单里的
Save As HTML，它只保存纯 DOM 结构，没 CSS - 要用
markdown-it或Typora等专用工具导出；VSCode 中推荐装扩展Markdown Preview Enhanced（注意不是官方那个“Preview”） - 装完后右键 →
Markdown Preview Enhanced: Export to HTML/PDF，它会嵌入完整样式表和字体 - PDF 导出依赖本地
Pandoc或Chrome/Edge，扩展设置里必须填对浏览器路径，否则报错Failed to launch browser
最常被忽略的是：预览窗口关掉后，导出功能就失效 —— 它需要先打开预览，再执行导出命令。这个依赖关系没文档明说，但确实存在。
