Sublime Text 无法直接导出 Markdown 为 PDF,必须依赖外部工具链;推荐使用 MarkdownPreview 插件配合 wkhtmltopdf,需手动安装并配置路径,且“漂亮 PDF”的实现关键在于 CSS 与转换器的细节配置。

Sublime Text 本身不支持 Markdown 转 PDF,也无内置导出功能——所有“一键转PDF”方案都依赖外部工具链,且必须手动配置。直接装插件不配环境,90% 情况下会报错 command not found: pandoc 或 Failed to launch wkhtmltopdf。
为什么不能只装 MarkdownPreview 插件?
MarkdownPreview 插件(MarkdownPreview)默认只渲染 HTML 预览,即使勾选了 "enable_pdf_export": true,它仍需要系统已安装并可调用的 PDF 渲染引擎:
-
pandoc+LaTeX(生成学术级排版,但安装大、编译慢) -
wkhtmltopdf(将 HTML 快速转 PDF,轻量但对 CSS 支持有限) -
chrome/chromium(通过 Puppeteer 或命令行 headless 模式导出,效果最接近预览)
插件不会自动帮你装这些——它只负责调用。没装或路径不对,Export to PDF 菜单项灰掉,或执行时报错。
推荐方案:用 MarkdownPreview + wkhtmltopdf(Windows/macOS/Linux 通用)
这是平衡易用性、输出质量和配置成本的最佳路径。关键步骤如下:
- 下载并安装
wkhtmltopdf:去官网 wkhtmltopdf.org/downloads.html 选对应系统版本,安装时勾选「Add to system PATH」(Windows)或确认/usr/local/bin已在$PATH(macOS/Linux) - 在 Sublime 中打开
Preferences → Package Settings → Markdown Preview → Settings,写入:
{
"enabled_parsers": ["markdown"],
"enable_pdf_export": true,
"pdf_converter": "wkhtmltopdf",
"wkhtmltopdf_path": ""
}
"wkhtmltopdf_path" 留空即可(插件会自动查 PATH);若填了绝对路径,请确保指向的是可执行文件,比如 /usr/local/bin/wkhtmltopdf 或 C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.exe。
重启 Sublime,右键 Markdown 文件 → Markdown Preview → Export to PDF,生成的 PDF 会保留基础样式(标题、列表、代码块),但自定义 CSS 需额外配置 css_js_files。
导出“漂亮”PDF 的真实限制在哪?
所谓“漂亮”,往往指中文字体、页眉页脚、目录、语法高亮等。但这些不是 Sublime 决定的,而是由你选择的转换器和模板控制:
-
wkhtmltopdf默认不嵌入中文字体,中文会显示为方框——需在 CSS 中指定本地字体,如font-family: "PingFang SC", "Microsoft YaHei", sans-serif;,并确保系统已安装 - 页眉页脚需在设置中启用:
"pdf_header_html"和"pdf_footer_html",值为 HTML 字符串或本地文件路径 - 目录(TOC)需配合
--toc参数,但 MarkdownPreview 当前版本(v3.0.5)不支持透传该参数,必须改用pandoc方案或写自定义 build system - 代码块高亮依赖
highlight.js或Pygments渲染后的 HTML,若预览里没高亮,PDF 也不会有
也就是说,“导出漂亮 PDF”这件事,80% 工作量在 CSS 和转换器配置上,Sublime 只是触发器。
真正卡住人的,从来不是“怎么点菜单”,而是 wkhtmltopdf 找不到字体、pandoc 缺 xelatex、或者 CSS 里写了 @page { size: A4; } 却忘了加 @media print 适配——这些细节不试一遍根本看不出问题。



















