vscode原生仅支持markdown实时预览,不支持导出pdf;稳定导出需装插件并确保预览已真实渲染内容,底层依赖chromium或latex:ctrl+shift+v失效需确认文件后缀为.md、已保存且内置扩展启用;导出失败常见于chrome路径未配置、puppeteer缺失、html语法错误或中文字体未fallback。

VSCode 原生只支持 Markdown 实时预览,不支持导出 PDF;想稳定导出,必须装插件,且不能只靠“点一下”——关键在预览器是否真正渲染了你要的内容,以及底层用的是 Chromium 还是 LaTeX。
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)。
导出 PDF 失败的常见报错和对应解法
导出失败往往不是配置错,而是环境链路断在某个隐性环节:
-
Failed to launch chrome:不是你没装 Chrome,而是插件找不到可执行路径。Windows 上 Chrome 默认不加 PATH,macOS 上新版 Chrome 不再注册命令行别名。解决方式是手动填markdown-pdf.executablePath(如/Applications/Google Chrome.app/Contents/MacOS/Google Chrome) -
Puppeteer not found:这是Markdown Preview Enhanced自带 Puppeteer 版本太老,跟系统 Chromium 冲突。建议全局安装新版:npm install -g puppeteer,再在设置里指定markdown-preview-enhanced.puppeteerPath - 导出空白页:文档里含未闭合的 HTML 标签(如
<div> 没配 <code>











