Sublime Text 无法原生导出排版内容,必须依赖ExportHtml插件生成HTML后再转PDF;需关闭wrap_lines、开启full_page和Use current color scheme,并用Chrome打印时勾选Background graphics、关闭页眉页脚、缩放设为100%或Fit。

Sublime Text 本身不提供「导出排版内容」的功能——所谓排版,比如带语法高亮的代码、带样式的 Markdown 渲染结果、可打印的 PDF 或 Word 文档,全得靠外部工具链补足。没有插件或命令行介入,你只能保存纯文本。
ExportHtml 插件导出 HTML 必须关 wrap_lines 和开 full_page
这是目前 Sublime Text 4 下最稳定、主题兼容性最好的 HTML 导出路径。它把当前 color_scheme 和 syntax scope 映射为内联 CSS,生成单文件 HTML,无需服务器或构建步骤。
- 必须勾选
Use current color scheme:否则高亮退化成灰底黑字 - 必须勾选
full_page:不勾则只输出<pre class="brush:php;toolbar:false;"><code></code> 片段,无 <code></code> 结构、无样式表,粘贴进 Word 或邮件就丢色</pre> - 务必关闭
wrap_lines:开启后会在长行中插入<wbr></wbr>或强制换行,Chrome 打印 PDF 时可能把get_user_profile断成两行,破坏可读性 -
include_line_numbers建议关掉:插件生成的行号列宽不可控,PDF 中易挤压代码区;编辑器自带行号更准、更稳
Chrome 打印 HTML 为 PDF 的三个硬性设置
导出的 HTML 在浏览器里看着正常,不代表 PDF 就能正确呈现。Safari/Firefox 对 @media print 支持弱,高亮常变浅甚至消失,必须用 Chrome 或 Edge。
- 打印前必须勾选
Background graphics:否则所有背景色(包括主题配色块)全丢,只剩黑字白底 - 务必关闭页眉页脚:否则每页顶上多一行 URL,底下一串页码,覆盖代码
- 缩放选
100%或Fit:选Shrink to fit容易导致字体模糊、行距压缩、中文字体发虚
中文显示异常不是插件问题,是 font-family 没声明中文字体
导出的 HTML 在 Chrome 里显示正常,但 PDF 中文成方块或发虚,根本原因是 CSS 中 font-family 缺少中文字体 fallback。
- 用文本编辑器打开生成的
.html文件,定位到<style></style>块里的font-family声明 - 替换为:
font-family: 'Fira Code', 'Consolas', 'Microsoft YaHei', 'STHeiti', monospace; - Windows 用户确保已安装
Microsoft YaHei,macOS 用户确认STHeiti存在(较新系统默认有) - 若仍发虚,反直觉但有效:Chrome 打印设置里关掉
Background graphics,能触发更好的字体抗锯齿渲染
想导出 Word?pandoc 构建系统要加双引号和 --reference-doc
Sublime 无法直接导出 .docx,必须通过 pandoc 转换。常见失败点不是语法写错,而是路径含空格或样式失控。
- 构建命令中的路径变量必须加双引号:
"shell_cmd": "pandoc \"${file}\" -o \"${file_path}/${file_base_name}.docx\"" - 默认输出排版简陋——标题无层级、无目录、字体不统一,这不是 pandoc 的锅,而是没指定模板
- 准备一个
template.docx(设好标题样式、正文字体、页眉页脚),在命令中加入:--reference-doc="/path/to/template.docx" - 中文/公式支持需补参数:
--from=markdown+tex_math_dollars --filter=pandoc-citeproc
最容易被忽略的是:ExportHtml 不会自动读取你改过的字体大小或行高,导出的 HTML 默认用 12px/1.4em;如果项目交付对字号敏感,得手动改生成 HTML 里的 body 或 code 样式。还有,所有操作前请确认文件已保存——插件遇到未命名或未保存文件会直接报 No file name。

















