怎样使用VSCode的Markdown预览和导出功能【教程】

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 不会自动更新，修改源文件后需重新导出
• 图片路径默认为相对路径，若源文件含 ![](assets/img.png)，导出 HTML 会保留该引用，但浏览器可能因安全策略无法加载本地资源
• 如需离线可用且样式完整，建议配合 markdown-it CLI 或 pandoc 导出，而非依赖 VSCode 内置功能

真正麻烦的不是“怎么点”，而是导出后样式错乱、图表不渲染、中文目录乱码——这些往往卡在插件配置和本地环境链路上，而不是操作步骤本身。