VSCode原生不支持导出PDF,所有导出功能均依赖插件;预览是否实时、公式与Mermaid能否渲染、中文是否方块,取决于文件后缀为.md、已保存、内置扩展启用、mathjax开关打开、Mermaid插件安装及JS执行支持等关键配置。

VSCode 原生不支持导出 PDF,所谓“一键导出”全是插件行为;预览是否实时、公式能否渲染、中文是否方块,全取决于几个关键配置是否打开、路径是否写对、文件是否已保存。
Ctrl+Shift+V 没反应?先确认这三件事
快捷键失效不是插件坏了,而是 VSCode 根本没把当前文件当 Markdown 处理:
- 文件后缀必须是
.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 不显示?检查开关和语法格式
原生预览默认禁用扩展语法,不是不支持,是关着的:
- 数学公式:设
markdown.preview.mathjax为true,且公式块前后必须空行,$$\int_0^1 x^2 dx$$才有效;行内公式$E = mc^2$需额外开启markdown.extension.math.inlineEnabled(若用了Markdown All in One) - Mermaid 图表:原生预览完全不支持;必须装
Mermaid Preview插件,或用Markdown Preview Enhanced并在设置中勾选Enable Mermaid,代码块必须声明语言为mermaid,例如:graph LR\nA --> B
- 脚本和内联样式被拦截?检查
markdown.preview.enableScripts是否为true(仅限本地可信文档)
导出 PDF 失败常见报错与解法
导出失败往往不是配置错,而是环境链路断在某个隐性环节:
-
Failed to launch chrome:不是你没装 Chrome,而是插件找不到可执行路径。Windows 上 Chrome 默认不加 PATH,macOS 上新版 Chrome 不再注册命令行别名。解决方式是手动填markdown-pdf.executablePath(如/Applications/Google Chrome.app/Contents/MacOS/Google Chrome) -
command 'markdown.exportToPDF' not found:VSCode 内置没有这个命令,说明你没装插件,或装了但被禁用。搜一下命令面板:Ctrl+Shift+P→ 输入export,看有没有Markdown PDF: Export (pdf)或Markdown Preview Enhanced: Export to PDF - 导出空白页:文档里含未闭合的 HTML 标签(如
<div> 没配 <code>











