Export to PDF 菜单项灰色是因为 Sublime 未找到 pandoc 或 wkhtmltopdf:需手动安装对应工具、验证终端可运行、配置正确路径,并确保语法设为 GitHub Flavored Markdown。

Export to PDF 菜单项灰色、点击无反应、生成乱码 PDF——不是 Sublime 有问题,而是它根本没找到可用的 PDF 渲染工具。你装了插件不等于装了 pandoc 或 wkhtmltopdf,这两者是独立程序,必须手动安装、验证、再告诉 Sublime 去哪找。
为什么 Export to PDF 菜单项是灰色的?
这不是插件没启用,是触发条件全没满足:
-
MarkdownPreview插件必须已安装(别用已废弃的MarkdownPDF,它硬编码调用淘汰多年的phantomjs) - 当前文件语法必须设为
GitHub Flavored Markdown(右键 → Set Syntax → Markdown (GFM)) - 终端能运行
pandoc --version或wkhtmltopdf --version,但 Sublime 的环境变量里没有——Mac 上brew install pandoc后真实路径常是/opt/homebrew/bin/pandoc,而 Sublime 默认只查/usr/bin -
enable_pdf_export配置开了,但pdf_converter指定的工具实际不可用
用 MarkdownPreview + wkhtmltopdf 最省事
适合大多数技术笔记、会议纪要类文档,不依赖 LaTeX,编译快、体积小:
- 去
wkhtmltopdf.org/downloads.html下载对应系统版本,Windows 安装时务必勾选「Add to system PATH」;macOS/Linux 确保/usr/local/bin在 shell 的$PATH中 - 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-build + pandoc 控制排版质量
需要目录、页眉页脚、数学公式或精确中文字体?必须走 pandoc + lualatex 路线,但代价是安装大、编译慢、字体配置不能漏:
- 菜单 →
Tools → Build System → New Build System…,粘贴并保存为Markdown2PDF.sublime-build -
"cmd"必须写pandoc全路径(如/opt/homebrew/bin/pandoc),不能只写"pandoc" -
"selector"必须是"source.gfm",否则按Ctrl+B不触发 -
"path"填你本地pandoc所在目录(多个用英文冒号分隔),例如:"/opt/homebrew/bin:/usr/local/bin" - 中文 PDF 乱码?加参数
--pdf-engine=lualatex和-V mainfont=Noto Sans CJK SC(macOS/Linux);Windows 可换为SimSun或Microsoft YaHei,且需先确认系统已装该字体(运行fc-list | grep "Noto"或查字体册)
导出 HTML 再打印为 PDF 是最稳的兜底方案
如果你只是想快速交付一份带代码块高亮、结构清晰的 PDF,这条路绕过所有 LaTeX 配置、字体声明和路径问题:
- 装好
MarkdownPreview后,按Shift+Cmd+P(Mac)或Ctrl+Shift+P(Win/Linux)输入Markdown Preview并回车预览 - 在浏览器预览页右键 → 打印 → 选择“另存为 PDF”
- 可配合浏览器扩展(如 Print Friendly & PDF)进一步清理样式、隐藏无关元素
真正卡住人的从来不是 Sublime 设置,而是误以为“装了插件就等于装好了工具”。pandoc、wkhtmltopdf、Chrome 都得自己装、自己验证、自己告诉 Sublime 去哪找——少一步,菜单就灰一步。



















