Sublime如何设置Markdown转PDF？Sublime导出漂亮的PDF文档

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

这里先说一个核心事实：Sublime Text 本身并不支持将 Markdown 直接转为 PDF，也没有内置的导出功能。市面上所有看似“一键转PDF”的方案，本质上都依赖一套外部工具链，并且必须手动配置。如果只是安装了插件而不配置环境，十有八九会遇到 command not found: pandoc 或 Failed to launch wkhtmltopdf 这类报错。

为什么不能只装 MarkdownPreview 插件？

很多朋友第一步就卡在这里。MarkdownPreview 插件（MarkdownPreview）默认只负责在浏览器里渲染 HTML 预览。即便你在设置里勾选了 "enable_pdf_export": true，它也只是提供了一个调用接口，真正把内容变成 PDF 的“重体力活”，需要系统里已经安装好并能被调用的 PDF 渲染引擎来完成。常见的引擎有这么几种：

• pandoc + LaTeX：学术排版的首选，效果精美，但安装包巨大，编译过程也相对缓慢。
• wkhtmltopdf：将 HTML 快速转换为 PDF，非常轻量，但对复杂 CSS 的支持有一定局限。
• chrome / chromium：通过无头浏览器模式导出，效果最接近你在浏览器里看到的样子。

关键在于，插件本身不会自动帮你安装这些引擎——它只负责调用。如果系统里没有，或者安装路径不对，那么 Export to PDF 这个菜单项要么是灰色的，要么一点击就会报错。

推荐方案：用 MarkdownPreview + wkhtmltopdf（Windows/macOS/Linux 通用）

综合考虑易用性、输出质量和配置成本，这条路径是目前最平衡的选择。具体怎么走？关键几步得踩准：

• 第一步，下载并安装 wkhtmltopdf：前往官网 wkhtmltopdf.org/downloads.html，选择对应你操作系统的版本。安装时，Windows 用户务必勾选「Add to system PATH」；macOS 或 Linux 用户则要确认安装后，/usr/local/bin 这样的目录已经包含在你的系统 $PATH 环境变量里。
• 第二步，配置 Sublime 插件：在 Sublime Text 中，打开 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 Text。现在，在 Markdown 文件上右键，选择 Markdown Preview → Export to PDF，生成的 PDF 就会保留基础样式，比如标题、列表和代码块。当然，如果你想使用自定义的 CSS 样式，还需要额外配置 css_js_files 选项。

导出“漂亮”PDF 的真实限制在哪？

大家追求的“漂亮”，往往不只是有文字和段落，还希望包含中文字体、页眉页脚、自动目录、代码语法高亮等等。但必须明确一点：这些效果并非由 Sublime Text 决定，而是取决于你选择的转换引擎以及你为它提供的模板和样式。

• 中文字体问题：wkhtmltopdf 默认不会嵌入中文字体，直接导出中文 PDF 很可能看到一堆方框。解决办法是在你的 CSS 文件中明确指定本地字体，例如 font-family: "PingFang SC", "Microsoft YaHei", sans-serif;，并确保这些字体在系统里确实已安装。
• 页眉页脚：这需要在插件设置中启用 "pdf_header_html" 和 "pdf_footer_html" 选项，其值可以是 HTML 字符串，也可以是一个本地 HTML 文件的路径。
• 自动目录（TOC）：wkhtmltopdf 本身支持通过 --toc 参数生成目录，但 MarkdownPreview 插件当前版本（如 v3.0.5）并不支持透传这个参数。要实现目录，要么改用 pandoc 方案，要么自己编写自定义的构建系统（build system）。
• 代码高亮：PDF 里的代码高亮，依赖于 HTML 预览阶段是否已经应用了高亮样式（比如通过 highlight.js 或 Pygments）。如果在浏览器预览里代码块就是纯文本，那么导出的 PDF 里也不会有颜色。

所以说到底，“导出漂亮 PDF”这件事，大约 80% 的工作量都花在了 CSS 样式设计和转换引擎的细节配置上，Sublime Text 更像是一个优雅的触发器。

真正让过程卡壳的，从来不是“哪个菜单项”，而是那些藏在背后的细节：wkhtmltopdf 找不到指定的中文字体、pandoc 缺少 xelatex 组件、或者 CSS 里写了 @page { size: A4; } 却忘了用 @media print 规则来适配打印样式——这些坑，不亲手完整走一遍流程，是很难提前预见的。