export to pdf 菜单项灰色是因为四个条件均未满足：文件语法未设为github flavored markdown、未安装markdownpreview插件、pandoc或wkhtmltopdf未安装或sublime找不到其路径、插件配置中enable_pdf_export为false或pdf_converter指向无效工具。
Export to PDF 菜单项为什么一直是灰色？
不是插件没装，而是四个条件一个没满足：当前文件语法没设成 GitHub Flavored Markdown、MarkdownPreview 插件没装（别用已淘汰的 MarkdownPDF）、pandoc 或 wkhtmltopdf 没装或 Sublime 找不到、插件配置里 enable_pdf_export 为 false 或 pdf_converter 指向了不存在的工具。
右键文件右下角语法名 → Set Syntax → Markdown (GFM)；终端运行 pandoc --version 必须有输出；Mac 用户尤其注意：brew 安装后真实路径常是 /opt/homebrew/bin/pandoc，而 Sublime 默认只查 /usr/bin，不显式指定就找不到。
用自定义 .sublime-build 替代插件菜单导出
比改 MarkdownPreview 设置更稳、路径可控、错误可见。新建构建系统后，关键字段必须对齐：
-
"cmd"值必须填pandoc全路径，例如"/opt/homebrew/bin/pandoc"，只写"pandoc"会报command not found -
"selector"必须是"source.gfm"，否则按Ctrl+B不触发 -
"path"填所有可能路径，用英文冒号分隔，例如"/opt/homebrew/bin:/usr/local/bin"，少一个就找不到可执行文件 - 中文字体不乱码要加参数：
--pdf-engine=lualatex -V mainfont="Noto Sans CJK SC"（Windows 可换为"SimSun"）
中文 PDF 排版不出错的关键参数
仅靠 pandoc 默认行为，中文几乎必然乱码或缺字。真正起作用的是这三样：
-
--pdf-engine=lualatex：必须指定，xelatex 对中文字体支持不稳定，lualatex 更可靠 -
-V mainfont="Noto Sans CJK SC"：字体名必须和系统已安装字体完全一致，macOS 可用fc-list :lang=zh查，Windows 建议用"Microsoft YaHei" -
--toc --toc-depth=3：加目录才像正式文档，但若没配好字体，目录页也会方块化
漏掉任意一项，生成的 PDF 都可能显示为“□□□”或直接编译失败。
为什么 wkhtmltopdf 方案更轻量但限制多？
它不走 LaTeX，所以安装快、编译快、PDF 小，适合会议纪要、技术笔记这类纯内容文档。但它本质是把 HTML 渲染成 PDF，所以：
- CSS 支持有限：
flex、grid、@page分页控制基本失效 - 数学公式只能靠 KaTeX 渲染，不能用 LaTeX 原生语法
-
wkhtmltopdf_path留空即可——插件会查$PATH；但若手动填路径，必须指向可执行文件，比如/usr/local/bin/wkhtmltopdf或C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.exe
真正难的从来不是装工具，而是让 Sublime 的环境变量和 pandoc 的字体路径对得上；这两个地方错一点，PDF 就是空白页或满屏方块。
