Sublime Text 本身不支持 Markdown 直接导出 PDF，Export to PDF 菜单项灰色主因是：未设语法为 GitHub Flavored Markdown、未安装 MarkdownPreview 插件、或缺失 pandoc/wkhtmltopdf 等外部工具及正确路径配置。
Sublime Text 本身不提供 Markdown 导出 PDF 功能，所有“导出”都是调用外部工具链完成的；菜单里 Export to PDF 灰掉、点击无反应、生成乱码 PDF，90% 是因为 pandoc / wkhtmltopdf / Chrome 没装好，或路径没对上。
Export to PDF 菜单项为什么是灰色的？
这不是插件没启用，而是触发条件缺失：
- 当前文件语法未设为
GitHub Flavored Markdown（右键 → Set Syntax →Markdown (GFM)） -
MarkdownPreview插件未安装，或装的是已废弃的MarkdownPDF（它硬编码调用phantomjs，2026 年完全失效） - 系统没装
pandoc或wkhtmltopdf，终端运行pandoc --version无输出 - 即使装了，Sublime 的环境变量也找不到它——Mac 上
brew install pandoc后实际路径常是/opt/homebrew/bin/pandoc，但 Sublime 默认只查/usr/bin
用自定义 Build System 实现稳定导出
比改插件设置更透明、更可控。推荐用 pandoc+lualatex 引擎，适合带目录、页眉页脚的正式文档：
-
"cmd"必须写pandoc全路径，不能只写"pandoc"（否则找不到命令） -
"selector"必须是"source.gfm"，否则.md文件里按Ctrl+B不触发 -
"path"填你本地pandoc所在目录（多个路径用英文冒号分隔），例如："/opt/homebrew/bin:/usr/local/bin"
{ "cmd": ["/opt/homebrew/bin/pandoc","-s","--pdf-engine=lualatex","-V","mainfont=Noto Sans CJK SC","-o","$file_base_name.pdf","$file"], "selector":"source.gfm", "path":"/opt/homebrew/bin:/usr/local/bin", "working_dir":"$file_path" }
中文 PDF 乱码、字体丑、段落挤在一起怎么办？
这不是 Sublime 的问题，是渲染链路缺字体声明：
-
pandoc默认用lualatex或xelatex，但不指定中文字体就 fallback 到拉丁字体，中文变方块 -
-V mainfont=Noto Sans CJK SC这个参数不能省；macOS/Linux 常用该字体，Windows 可换为SimSun或Microsoft YaHei - 如果系统没装对应字体，
pandoc编译会报错或静默失败；可先运行fc-list | grep "Noto"（Linux/macOS）或检查字体册（macOS）确认存在
导出 HTML 再打印为 PDF 是最省事的路径
安装 MarkdownPreview 后，用 Shift+Cmd+P（Mac）或 Ctrl+Shift+P（Win/Linux）输入 Markdown Preview: Preview in Browser，回车预览；在浏览器预览页右键 → 打印 → 选择“另存为 PDF”。
这条路绕过所有 LaTeX 配置、字体声明和路径问题，适合含代码块、需快速交付的文档。真正卡住人的从来不是 Sublime 设置，而是以为“装了插件就等于装了工具”。pandoc 和 wkhtmltopdf 是两个独立程序，得自己装、自己验证、自己告诉 Sublime 去哪找。
