ExportHtml插件导出HTML后必须用Chrome打印，因Sublime不支持一键转PDF；需勾选full_page和Use current color scheme，关闭wrap_lines，手动拖入Chrome再Ctrl+P打印并勾选Background graphics。
ExportHtml 插件导出 HTML 后必须用 Chrome 打印
Sublime Text 本身不支持一键转 PDF，所谓“一键”实际是两步：先用 ExportHtml 生成 HTML，再手动在 Chrome 里打印为 PDF。这步不能跳过，也不支持自动保存——所有声称“点一下就出 PDF”的插件，要么已失效（如硬编码调用 phantomjs 的老版 MarkdownPDF），要么静默失败。
常见错误现象：
-
ExportHtml: Export执行后打开的是 Safari 或 Firefox，结果高亮错乱、中文字体变方块 - 生成的 HTML 打开是白底黑字，没颜色——大概率漏勾了
Use current color scheme - PDF 里代码被奇怪折行，比如
get_user_data()拆成两行——wrap_lines被误开了
实操建议：
- 安装
ExportHtml后，按Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入ExportHtml: Export回车 - 弹出配置面板时，必须勾选：
full_page、Use current color scheme；建议关闭：wrap_lines、include_line_numbers（行号用编辑器原生显示更准） - 生成的
.html文件默认用系统默认浏览器打开，**务必手动拖进 Chrome 或 Edge**，再按Ctrl+P→ 勾选Background graphics→ 输出为 PDF
Markdown 文件导出 PDF 前四件事必须做完
菜单里 Export to PDF 灰掉不是插件没装，而是四个条件缺一不可。少一个，点击就无反应或输出乱码 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 -
Preferences → Package Settings → Markdown Preview → Settings中，"enable_pdf_export": true且"pdf_converter"指向真实可用的工具（如"wkhtmltopdf"或"pandoc"）
自定义 .sublime-build 是唯一可控排版路径
如果需要目录、页眉页脚、数学公式或精确中文字体控制，必须走 pandoc + lualatex 构建系统。靠插件菜单点出来的 PDF 几乎无法调这些参数。
关键配置项：
-
"cmd"字段必须写pandoc全路径，例如："/opt/homebrew/bin/pandoc"；只写"pandoc"会报command not found -
"selector"必须是"source.gfm"，否则.md文件里按Ctrl+B不触发构建 - 中文不乱码的核心参数：
--pdf-engine=lualatex和-V mainfont="Noto Sans CJK SC"（macOS/Linux），Windows 用户换为"SimSun"或"Microsoft YaHei" -
"path"字段填所有可能路径，用英文冒号分隔，例如："/opt/homebrew/bin:/usr/local/bin:/usr/bin"，少一个就找不到pandoc
中文字体模糊、背景变灰的根因与修复
问题不在 Sublime，而在导出的 HTML 的 CSS 声明缺失或浏览器打印设置冲突。Chrome 打印时若字体发虚、背景灰掉，基本是这两处没对：
- 生成的
.html文件里，<style>块中的font-family缺失中文字体 fallback，手动替换成：font-family: 'Fira Code', 'Consolas', 'Microsoft YaHei', 'STHeiti', sans-serif; - Chrome 打印设置里没勾选
Background graphics，导致配色方案里的背景色、高亮色全被丢弃 - Mac 用户注意：
ExportHtml对新格式.sublime-color-scheme支持不稳定，若高亮全灰，可临时切换主题为Monokai.tmTheme测试
真正麻烦的从来不是“怎么导出”，而是“导出后哪一行字没对齐”“哪个括号背景色漏了”“PDF 第二页标题跑偏了”——这些细节得靠反复打开 HTML、调 font-family、试打印缩放比才能压住。
