Export to PDF菜单灰色是因为Sublime找不到pandoc、wkhtmltopdf或weasyprint:它们未安装,或已安装但路径未正确配置进Sublime环境;需手动验证命令可用性并显式设置path字段。

Export to PDF 菜单项灰色,不是插件没装对,是 Sublime 根本找不到 pandoc、wkhtmltopdf 或 weasyprint —— 它们一个都没装,或者装了但路径没配进 Sublime 的环境里。
Export to PDF 为什么是灰色的?
- 这个菜单项由
MarkdownPreview插件提供,但它不自带任何 PDF 渲染能力,只负责调用系统命令 - 如果你运行过
pandoc --version或wkhtmltopdf --version,终端报command not found,那它在 Sublime 里也一定失败 - Mac 用户尤其容易踩坑:
brew install pandoc后,真实路径常是/opt/homebrew/bin/pandoc,而 Sublime 默认只查/usr/bin,不显式写进path就等于没装
怎么让 MarkdownPreview 真正导出 PDF?
- 打开
Preferences → Package Settings → Markdown Preview → Settings - 确保启用 PDF 导出并指定转换器:
{ "enable_pdf_export": true, "pdf_converter": "wkhtmltopdf", "wkhtmltopdf_path": "" } -
"wkhtmltopdf_path"留空即可(插件会自动查$PATH);如果填了,必须是可执行文件的绝对路径,比如:- macOS:
/usr/local/bin/wkhtmltopdf或/opt/homebrew/bin/wkhtmltopdf - Windows:
C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.exe
- macOS:
用自定义 .sublime-build 更稳,但要注意三点
-
selector必须设为source.gfm,否则按Ctrl+B不触发构建 -
path字段要覆盖你本地所有可能的工具路径,用英文冒号分隔,例如:"/opt/homebrew/bin:/usr/local/bin:/usr/bin" - 中文 PDF 乱码?不是字体没装,是
pandoc没被告知用哪个字体。加参数:--pdf-engine=lualatex和-V mainfont=Noto Sans CJK SC(macOS/Linux),Windows 可换为SimSun
导出 HTML 再打印为 PDF 是最省事的路径
- 安装
MarkdownPreview后,用Shift+Cmd+P(Mac)或Ctrl+Shift+P(Win/Linux)输入Markdown Preview,回车预览 - 在浏览器预览页右键 →
打印→ 选择“另存为 PDF” - 这条路绕过所有 LaTeX 配置、字体声明和路径问题,适合含代码块、需快速交付的文档
真正卡住人的从来不是 Sublime 设置,而是以为“装了插件就等于装了工具”。pandoc 和 wkhtmltopdf 是两个独立程序,得自己装、自己验证、自己告诉 Sublime 去哪找。
WiseOCR — 将 PDF 或图片文件转换为高质量 Markdown 文本,支持表格完整识别、多栏版式还原、中英文混排。适用场景:扫描件文字提取、纸质文档数字化、合同/报告/论文转文本、图片中文字提取。支持格式:PDF、JPG、JPEG、PNG、WEBP、GIF、BMP、TIFF。触发:用户上传文件并要求"帮我识别这个文件的文字"、"PDF转文字"、"图片转文本"、"帮我提取这个表格"——会调用本技能。说"用Wi










