VSCode原生仅支持Markdown实时预览,不支持导出PDF/HTML;需安装Markdown PDF等插件实现导出,且导出效果受Chromium可用性、CSS配置及图表插件兼容性影响。

VSCode 自带的 Markdown 预览功能开箱即用,但导出为 PDF/HTML 需要额外配置或插件——纯内置功能只支持预览,不支持导出。
如何快速打开 Markdown 实时预览
在编辑 .md 文件时,按下 Ctrl+Shift+V(Windows/Linux)或 Cmd+Shift+V(macOS)即可在右侧分栏启动实时预览。预览内容随编辑自动刷新,支持 GitHub 风格渲染(如表格、任务列表、代码块语法高亮)。
- 若快捷键无效,检查是否被其他插件占用;可右键编辑器空白处选「Open Preview」
- 预览页不支持直接复制 HTML 或导出,仅用于查看
- 预览默认使用 VSCode 内置解析器,不识别某些扩展语法(如 Mermaid 流程图需安装对应插件)
为什么 Ctrl+P 输入「export」找不到导出命令
因为 VSCode 原生不提供 Markdown: Export to PDF 或类似命令。你看到的「export」提示通常来自第三方插件(如 Markdown All in One 或 Markdown PDF),而非核心功能。
- 原生命令面板(
Ctrl+P)中搜索Markdown:只会列出预览、折叠、格式化等操作 - 试图导出时出现「command 'markdown.exportToPDF' not found」错误,说明缺少对应插件
- 不同导出插件依赖不同底层工具(如
Markdown PDF依赖本地 PhantomJS 或 Puppeteer,而新版本更倾向用 Chromium)
推荐导出方案:用 Markdown PDF 插件生成 PDF
安装插件 Markdown PDF 后,右键编辑器 → 「Export to PDF」即可生成。它默认使用系统已安装的 Chromium(Chrome/Edge),无需额外配置二进制路径(VSCode 1.80+ 自动发现)。
- 首次导出失败常见原因是 Chromium 不可用:检查
chrome或msedge是否在PATH中,或手动配置markdown-pdf.executablePath - 导出效果受 CSS 控制,可自定义
markdown-pdf.css覆盖默认样式(如调整页边距、字体) - 不建议用该插件导出含大量 Mermaid 图表的文档——渲染不稳定,优先考虑
Markdown All in One+PlantUML组合
导出 HTML 更简单,但要注意样式丢失
VSCode 内置支持「Save as HTML」:右键预览窗口 → 「Save As HTML」。生成的 HTML 是单文件,内联基础样式,但不包含自定义 CSS 或 JS 动态功能。
- 保存后的 HTML 不会自动更新,修改源文件后需重新导出
- 图片路径默认为相对路径,若源文件含
,导出 HTML 会保留该引用,但浏览器可能因安全策略无法加载本地资源 - 如需离线可用且样式完整,建议配合
markdown-itCLI 或pandoc导出,而非依赖 VSCode 内置功能
真正麻烦的不是“怎么点”,而是导出后样式错乱、图表不渲染、中文目录乱码——这些往往卡在插件配置和本地环境链路上,而不是操作步骤本身。










