VSCode Markdown预览需保存文件且路径相对工作区根才生效；Ctrl+Shift+V失效主因是文件后缀非.md、语言模式非Markdown或快捷键被劫持；公式、Mermaid需手动启用配置，导出PDF须装插件。

VSCode 自带 Markdown 预览功能，不需要安装插件就能用，但“运行”不是浏览器那种双击即开——它必须在已打开的 .md 文件编辑器中手动触发，且默认不实时刷新，改完不保存就看不到变化。

Ctrl+Shift+V 没反应？先查这三件事

快捷键失效最常见原因不是插件没装，而是环境没对上：

• 当前文件后缀必须是 .md（.markdown 也行，但 .txt 或无后缀绝对不行）
• 右下角状态栏语言模式得是 Markdown，点一下可切换；如果显示 Plain Text，预览根本不会加载
• 快捷键被劫持：Vim / Emacs 插件、终端扩展、甚至某些输入法会吞掉 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、图片路径不渲染？原生支持有限

VSCode 内置预览只认 CommonMark 标准语法，扩展能力靠配置开关或插件补足：

Xlsx To Markdown

文档转 Markdown 转换器 - 将 DOCX、PPTX、Excel 文件转换为 Markdown。用于从 Word 文档、PowerPoint 演示文稿或 E... 提取内容。

下载

• 数学公式：设 markdown.math.enabled 为 true，文档里用 $$E=mc^2$$ 或 \(E=mc^2\)
• Mermaid 图表：设 markdown.mermaid.enabled 为 true，代码块必须声明语言：

  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 填的路径错也会静默失败

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