ctrl+shift+v没反应是因为文件未保存、后缀非.md/.markdown或内置markdown扩展未启用；公式和mermaid图不显示是因原生预览不支持，须用markdown preview enhanced并以$$或`mermaid正确书写；导出空白或方块字需检查chrome路径、puppeteer版本及css字体fallback设置。
Ctrl+Shift+V 没反应？先确认三件事
VSCode 不会把任意文本文件当 Markdown 处理，预览功能启动失败，90% 是卡在这三个基础条件上：
- 文件后缀必须是
.md或.markdown；Untitled-1这类未命名标签页永远无法触发预览 - 文件必须已保存（编辑器右上角无圆点），未保存状态不触发解析与监听
- 内置扩展
Markdown Language Features和Markdown Preview必须启用——去 Extensions 页面搜这两个名字，确保开关是开的
如果装了 Markdown Preview Enhanced，它会接管 Ctrl+Shift+V，此时原生快捷键失效；想用它，得改用 Ctrl+K V（Windows/Linux）或 Cmd+K V（macOS）。
公式、Mermaid 图不显示？别用原生预览
VSCode 原生 Markdown Preview 只支持 CommonMark 标准语法，对 $$ 公式、```mermaid 流程图、脚注、表格对齐等一概不解析——这不是你写错了，是它根本没这个能力。
解决办法只有一个：换预览器。推荐 Markdown Preview Enhanced（作者 shd101wyy），安装后右键 → Markdown Preview Enhanced: Open Preview to the Side，它会在侧边打开一个真正能执行 JS 的渲染环境。
- 公式要写成完整块级形式：
$$ \int_0^1 x^2 dx $$，漏一个$就整段失效 - Mermaid 必须用代码块包裹：
```mermaid+ 内容 +```，且不能嵌套在其他 HTML 标签里 - 导出前务必先打开它的预览窗口——否则右键菜单里压根没有
Export to PDF选项
导出 PDF 总是空白页或方块字？检查底层链路
“导出失败”不是配置错，而是某个隐性环节断了。常见报错和对应动作：
-
Failed to launch chrome：不是你没装 Chrome，而是插件找不到可执行路径。Windows 上 Chrome 默认不加 PATH；macOS 新版 Chrome 不再注册命令行别名。手动填markdown-pdf.executablePath或markdown-preview-enhanced.puppeteerPath（如/Applications/Google Chrome.app/Contents/MacOS/Google Chrome） -
Puppeteer not found：旧版插件自带 Puppeteer 太老，跟系统 Chromium 冲突。全局重装：npm install -g puppeteer，再指定路径 - 中文显示方框：CSS 没设字体 fallback。必须显式声明：
@font-face { font-family: 'pdf-font'; src: local('PingFang SC'), local('Microsoft YaHei'); }，再给body设font-family: 'pdf-font' - 导出空白页：文档里含未闭合 HTML 标签（如
<div> 没配 <code>
