Visual Studio Code 怎么把 Markdown 文件转换成 PDF？ 这个问题很常见。无论是写技术文档、做学习笔记，还是整理项目方案，Markdown 都是不少人的首选。这得益于它简洁的语法。但到了需要分享、打印或存档时，PDF 才是更稳妥的格式。而 VS Code 本身就能完成转换，关键就是选一个好用的扩展。

安装扩展

打开 Visual Studio Code。在左侧栏找到扩展图标（或按 Ctrl+Shift+X）。

在搜索框中输入 markdown to pdf，挑选一个评价不错的扩展安装。

装完后一定重启编辑器，扩展才能正式生效。这一步虽简单，但容易忽略。很多人装完发现命令没出来，就是因为少了重启这一步。

转换方法

使用扩展命令

扩展装好后，在 VS Code 里打开要转换的 Markdown 文件。

调出命令面板：按 F1 或 Ctrl+Shift+P。输入 Markdown to PDF 等关键词，找到对应命令。

接着会弹出窗口，让你选择输出路径和文件名。确认后点击“转换”。几秒钟后，PDF 就生成了。整个过程非常直观。

配置快捷键

如果经常做转换，每次都翻命令面板会有些繁琐。可以给转换操作配一个快捷键。

打开 VS Code 设置，搜索 keybindings.json。在配置文件中加入以下内容：

[
  {
    "key": "ctrl+alt+p",
    "command": "markdown-pdf.convert",
    "when": "editorTextFocus && editorLangId == 'markdown'"
  }
]

保存后，在 Markdown 文件里按下 Ctrl+Alt+P 即可一键转换。效率和体验都提升不少。

注意事项

样式兼容性

Markdown 中的自定义样式（如某些字体、颜色或特殊排版），转成 PDF 时不一定能完美保留。这与扩展的渲染引擎有关。

为了减少问题，建议尽量使用标准 Markdown 语法，少用花哨的 CSS 定制。这样生成的 PDF 在格式上不容易出错。

图片处理

如果文档中插了图片，务必确认：

• 图片路径正确
• 图片格式是 PDF 引擎支持的（常见格式基本没问题）

最典型的翻车场景是：引用了相对路径下的图片，但文件移动后路径就断了，导致 PDF 里出现裂图。解决方法：

• 使用绝对路径
• 或将图片与 Markdown 文件放在一起管理
• 转换前检查一下图片链接

总的来说，VS Code 配合 Markdown to PDF 扩展，基本能满足日常转换需求。无论是整理个人知识库，还是给团队输出报告，这套流程都足够轻量、高效。动手试一下，你会发现比想象中简单得多。

《夸克》非常好用的免费AI浏览器

下载APP查看