VSCode中Markdown转PDF有三种方法:一、用Markdown PDF插件依赖Chrome导出;二、用Markdown Preview Enhanced配合Pandoc支持公式与样式;三、用VSCode Tasks集成markdown-pdf CLI批量处理。

如果您在VSCode中编写Markdown文档,但需要将其转换为PDF格式进行分享或归档,则可能是由于缺少合适的导出工具或配置不当。以下是实现该目标的多种方法:
本文运行环境:MacBook Air,macOS Sequoia。
一、使用Markdown PDF插件直接导出
Markdown PDF插件是VSCode中专为Markdown转PDF设计的轻量级扩展,依赖系统已安装的Chrome或Chromium内核进行渲染,无需额外编译工具。
1、打开VSCode,在扩展市场搜索并安装Markdown PDF插件(作者:yzane)。
2、确保本地已安装Google Chrome或Microsoft Edge浏览器,并可通过命令行调用chrome或msedge命令。
3、打开一个.md文件,在编辑器右上角点击“Export PDF”按钮(图标为?+PDF),或按快捷键Cmd+Shift+P,输入“Markdown PDF: Export (pdf)”后回车。
4、导出后的PDF默认保存在当前文件所在目录,文件名与原Markdown文件一致。
二、通过Markdown Preview Enhanced插件配合Pandoc导出
Markdown Preview Enhanced提供更灵活的导出链路,支持调用Pandoc将Markdown经由LaTeX或HTML中间格式生成高质量PDF,适合含数学公式、复杂表格或自定义样式的文档。
1、安装Markdown Preview Enhanced插件(作者:shd101wyy)。
2、在终端执行brew install pandoc(macOS)或通过官网下载安装Pandoc 3.1+版本。
3、在VSCode中打开.md文件,右键选择“Markdown Preview Enhanced: Export to PDF”。
4、若提示缺失LaTeX引擎,可跳过LaTeX路径配置,选择使用HTML to PDF via Chrome模式完成导出。
三、使用Command Line + VSCode Tasks集成导出
通过VSCode内置任务功能,将Markdown转PDF流程自动化,避免手动触发插件界面,适用于需批量处理多个文档的场景。
1、在工作区根目录创建.vscode/tasks.json文件。
2、写入任务定义,调用markdown-pdf CLI工具(需全局安装:npm install -g markdown-pdf)。
3、配置task的args字段包含输入文件路径和输出路径,例如["${file}", "-o", "${fileBasenameNoExtension}.pdf"]。
4、按下Cmd+Shift+B运行任务,PDF将生成在当前文件同级目录。










