VSCode原生Markdown预览需文件保存后刷新，非实时；快捷键失效主因是文件后缀非.md、语言模式非Markdown或插件劫持Ctrl+Shift+V。

VSCode 自带 Markdown 预览功能，开箱即用，但“能打开”不等于“能正常用”——绝大多数问题都出在文件没保存、路径不对、或快捷键被劫持这三件事上。

Ctrl+Shift+V 没反应？先确认这三个前提

快捷键失效几乎从不因为功能被禁用，而是环境没对齐：

• 当前文件后缀必须是 .md（.markdown 也行，.txt 或无后缀绝对不行）
• 右下角状态栏语言模式必须是 Markdown（点一下可切换；若显示 Plain Text，预览压根不会加载）
• 快捷键可能被插件劫持：Vim、Emacs Keymap、终端扩展甚至某些输入法会吞掉 Ctrl+Shift+V；临时禁用这些插件，或改用命令面板：Ctrl+Shift+P → 输入 Markdown: Open Preview to the Side 直接运行

改了文字预览不动？不是坏了，是没保存

VSCode 预览读的是磁盘文件，不是编辑缓冲区。未保存的修改它完全看不见——这点和 Typora、Obsidian 有本质区别。

• 按 Ctrl+S 保存后，预览自动更新（前提是 markdown.preview.autoRefresh 为 true，默认就是）
• 想边写边看？开启自动保存：files.autoSave 设为 onFocusChange 或 afterDelay
• 预览窗口右上角的刷新按钮（↻）只重载 HTML，不读新内容；真正有效的是先保存再点

公式、Mermaid、图片不渲染？原生支持有限，得配开关

内置预览只认 CommonMark 标准语法，扩展能力靠显式配置激活：

Markdown → 图片卡片

当用户想要将Markdown内容转换为可分享的图片卡片时使用。触发词包括：转图片、做卡片、生成海报、生成分享图、把这个转成图片、export as image

下载

• LaTeX 公式：启用 markdown.math.enabled（VS Code 1.84+），且公式块前后需空行，$$E = mc^2$$ 才生效
• Mermaid 图表：启用 markdown.mermaid.enabled，代码块必须声明语言为 mermaid，例如：

  graph LR\nA --> B

• 本地图片路径：预览按工作区根目录解析，![alt](./img/logo.png) 中的 ./ 指的是工作区根，不是当前 .md 文件所在目录；路径错会导致图片空白且无报错

导出 PDF/HTML 失败？内置预览根本不支持导出

预览窗口右键“另存为”得到的是无样式的纯 HTML 快照，导出 PDF 更是完全不支持。

• 导出 HTML：用命令 Markdown: Export to HTML（需先打开预览）
• 导出 PDF：必须装插件，如 Markdown PDF；Linux 下常因缺 libxss1、libglib2.0-0 报 Failed to launch browser
• 导出失败时，打开开发者工具（Help → Toggle Developer Tools），看 Console 是否有 CSS 路径 404——markdown.preview.styles 填的路径错也会静默失败

真正卡住人的从来不是“怎么打开预览”，而是“为什么我改了它不认”。核心就两条：文件必须保存，路径必须相对工作区根。其他所有问题，基本都是这两条没守牢。