export to pdf 菜单项灰色是因为未满足全部触发条件：未安装 markdownpreview 插件、当前文件语法未设为 github flavored markdown、pandoc 或 wkhtmltopdf 未安装或 sublime 无法定位其路径；必须右下角设语法为 markdownediting → markdown gfm，且 markdownpreview 需通过 package control 安装。
Export to PDF 菜单项为什么一直是灰色？
不是插件没装，而是触发条件全不满足：MarkdownPreview 没装、当前文件语法没设成 GitHub Flavored Markdown、pandoc 或 wkhtmltopdf 未安装或 Sublime 找不到它们。
右下角点击语法名 → 选 MarkdownEditing → Markdown GFM 是必须操作；否则哪怕插件全装好，菜单也永远灰着。
-
MarkdownPreview必须从 Package Control 安装，别用已废弃的MarkdownPDF（它硬编码调用淘汰的phantomjs，2026 年起完全失效） - Mac 用户运行
pandoc --version成功，不代表 Sublime 能调用——brew 安装后真实路径常是/opt/homebrew/bin/pandoc，而 Sublime 默认只查/usr/bin - Windows 安装
wkhtmltopdf时务必勾选「Add to system PATH」，否则 Sublime 启动时读不到
用 MarkdownPreview + wkhtmltopdf 最快出 PDF
适合技术笔记、会议纪要这类纯内容文档，不依赖 LaTeX，编译快、体积小，但对 flex 布局、自定义分页等现代 CSS 支持弱。
配置要点：打开 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（macOS/Linux）或C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.exe（Windows） - 去
wkhtmltopdf.org/downloads.html下载对应系统版本，别用第三方打包版，兼容性差 - 导出前确保文件语法已设为
GitHub Flavored Markdown，否则Export to PDF不激活
用自定义 .sublime-build + pandoc 控制排版质量
需要目录、页眉页脚、数学公式、中文字体精确控制？必须走 pandoc + lualatex，但代价是安装大、编译慢、字体配置漏一项就乱码。
菜单 → Tools → Build System → New Build System…，粘贴并保存为 Markdown2PDF.sublime-build：
{
"cmd": ["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:/usr/bin",
"working_dir": "$file_path"
}
-
selector必须是source.gfm，否则按Ctrl+B不触发构建 -
mainfont参数不能省：中文 PDF 乱码、缺字、段落挤在一起，90% 是因为没指定中文字体；macOS/Linux 推荐Noto Sans CJK SC，Windows 可换为SimSun或Microsoft YaHei -
path字段列出所有可能路径，用英文冒号分隔；不确定就全写上，避免 Sublime 找不到pandoc
导出 HTML 再打印为 PDF 更少踩坑
如果你只是想把带语法高亮的 Markdown（比如含代码块的笔记）转 PDF，这条路最稳——绕过所有 LaTeX / wkhtmltopdf 兼容问题，靠 Chrome 打印渲染。
- 装
ExportHtml插件（Package Control 安装），快捷键Ctrl+Shift+P→ 输入ExportHtml: Export to HTML - 生成的
.html文件用 Chrome 打开 →Ctrl+P→ 选择“另存为 PDF”，勾选“背景图形”才能保留代码块高亮色 - 此法不依赖任何命令行工具，也不受字体缺失影响，适合临时交付、快速验证排版效果
真正麻烦的从来不是装插件，而是让 Sublime 找到你系统里那个真实的 pandoc 或 wkhtmltopdf 可执行文件——路径错半格，整个流程就卡死在灰色菜单上。
