“排版精美”的pdf导出需在速度、中文字体、目录页眉、安装复杂度间妥协；export to pdf灰色因四条件缺一不可：语法设为gfm、装markdownpreview插件、sublime环境变量含pandoc/wkhtmltopdf路径、enable_pdf_export为true且pdf_converter指向可用工具。
没有“完美导出”这回事——所谓“排版精美”，取决于你愿意为哪一环妥协：速度、中文字体、目录页眉、还是安装复杂度。直接用 MarkdownPreview 的 Export to PDF 菜单项，90% 情况下会灰掉或生成乱码 PDF，因为它根本不检查你有没有装对工具，只管调用。
Export to PDF 菜单项为什么是灰色的？
这不是插件没启用，而是四个条件缺一不可：
- 当前文件语法必须设为
GitHub Flavored Markdown（右键 → Set Syntax → Markdown (GFM)，不是普通的 Markdown） -
MarkdownPreview插件已安装（别用早已废弃的MarkdownPDF，它硬编码调用已淘汰的phantomjs） - 终端能跑通
pandoc --version或wkhtmltopdf --version，但 Sublime 的环境变量里找不到——Mac 上brew install pandoc后路径常是/opt/homebrew/bin/pandoc，而 Sublime 默认只查/usr/bin -
enable_pdf_export设为true，且pdf_converter指向的工具实际可执行（比如填了"pdf_converter":"pandoc"，但系统里只有wkhtmltopdf）
用自定义 .sublime-build + pandoc 实现可控排版
这是唯一能真正控制目录、页眉、数学公式和中文字体的路径，代价是安装大、编译慢、字体参数不能漏。
OCR 文档识别转 Markdown（WiseOCR）
下载
WiseOCR — 将 PDF 或图片文件转换为高质量 Markdown 文本，支持表格完整识别、多栏版式还原、中英文混排。适用场景：扫描件文字提取、纸质文档数字化、合同/报告/论文转文本、图片中文字提取。支持格式：PDF、JPG、JPEG、PNG、WEBP、GIF、BMP、TIFF。触发：用户上传文件并要求"帮我识别这个文件的文字"、"PDF转文字"、"图片转文本"、"帮我提取这个表格"——会调用本技能。说"用Wi
-
cmd字段必须写pandoc全路径（如/opt/homebrew/bin/pandoc），只写"pandoc"会报command not found -
selector必须是"source.gfm"，否则按Ctrl+B不触发构建 - 中文不乱码的关键是加这两项：
--pdf-engine=lualatex和-V mainfont="Noto Sans CJK SC"；Windows 用户请换为"SimSun"或"Microsoft YaHei" -
path字段要列全所有可能路径，用英文冒号分隔，例如："/opt/homebrew/bin:/usr/local/bin"，少一个就找不到pandoc
用 ExportHtml + Chrome 打印，适合代码类文档
如果你只是想把带语法高亮的 Markdown 或代码文件转成 PDF，这条路最稳、颜色保留最全、不用碰命令行。
- 导出前务必勾选
full_page（否则只导出代码块区域，无样式）和Use current color scheme（否则高亮变灰） - 生成的
.html文件必须用 Chrome 或 Edge 打开再打印——Safari/Firefox 对@media print支持弱，高亮常发虚 - 中文显示为方块？打开生成的 HTML，找到
<style></style>块里的font-family，手动替换成：font-family: 'Fira Code', 'Consolas', 'Microsoft YaHei', 'STHeiti', sans-serif; - Chrome 打印设置里，“背景图形”勾选与否效果相反：勾选有时糊字，不勾选反而提升中文字体抗锯齿——得试
真正容易被忽略的点是：Sublime 的构建系统和插件配置各自维护一套环境变量，PATH 不互通；你终端能跑通 pandoc，不代表 Sublime 能。每次改完配置，记得重启 Sublime，而不是只重载插件。
