sublime text 导出高亮 html 必须安装 exporthtml 插件,配置 pygments、语言识别和主题适配,再通过 chrome 打印转 pdf;其他插件或设置不当会导致样式丢失、乱码或黑屏。

Sublime Text 本身不提供导出 HTML 的功能,所谓“导出带高亮的 HTML”,全靠插件把当前语法高亮效果转成内联 CSS 写进 HTML 文件——没插件,就只有纯文本。
必须装 ExportHtml,别试 Copy as HTML 或老插件
ExportHtml 是目前唯一稳定支持 Sublime Text 4、持续更新、能正确映射 color_scheme 颜色并生成完整 HTML 文档结构的插件。Copy as HTML 只输出无 的 <div class="highlight"> 片段,粘到 Notion、语雀或邮件里极易样式丢失;<a style="color:#f60; text-decoration:underline;" title="sublime" href="https://m.php.cn/zt/15777.html" target="_blank">sublime</a>text-<a style="color:#f60; text-decoration:underline;" title="html" href="https://m.php.cn/zt/15763.html" target="_blank">html</a>-export 这类 2015 年停更的老插件,在 ST4 上会直接报 <code>ImportError: No module named 'urllib2'。
- 安装路径:按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS)→ 输入Package Control: Install Package→ 搜ExportHtml(结尾**不能有数字**)→ 回车 - 装完必须重启 Sublime,否则右键菜单不出现
Export Html选项 - 别手动 clone GitHub 仓库——路径错位、Python 环境混用、缺
pygments都会导致导出后全灰或白屏
导出前三件事没做,HTML 打开就是乱码或黑底白字
导出效果不是“点了就完事”,它强依赖当前视图状态和插件配置:
- 右下角状态栏必须显示具体语言(如
Python、JavaScript),不是Plain text;否则插件按纯文本处理,无任何高亮 - 执行
Preferences → Package Settings → ExportHtml → Settings – User,填入启用pygments的配置:{ "use_pygments": true, "pygments_style": "default", "line_numbers": false, "wrap_lines": false } - 终端运行
pip install pygments(Windows/macOS 均适用;macOS 权限错误时加--user)
导出后中文糊、行号错位、背景全黑?检查这三项
生成的 HTML 在浏览器里打开异常,问题通常不在插件本身,而在输出参数与环境不匹配:
使用 PptxGenJS 和 Python 解析,将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint(.pptx)演示文稿。
- 中文发虚或成方块:打开生成的 HTML 文件,找到
<style></style>块里的font-family,改成font-family: 'Fira Code', 'Consolas', 'Microsoft YaHei', 'STHeiti', monospace; - 行号挤占代码宽度:导出配置里关掉
include_line_numbers;编辑器原生行号更准,也避免 PDF 打印时折行错乱 - 背景黑但文字也是黑的:说明当前主题是暗色系(如
Monokai.sublime-color-scheme),但插件默认用了浅色 CSS;在 ExportHtml 设置中加"light_theme": true强制浅色背景,或改用html_style: "inline_dark"
想导出 PDF?别信“一键导出”,先过 Chrome 打印关
Sublime 没有原生 PDF 导出,所有“导出 PDF”本质都是 HTML + 浏览器打印。关键不是怎么导,而是怎么让打印结果不翻车:
- 导出时务必勾选
full_page,否则只生成<pre class="brush:php;toolbar:false;"><code></code> 块,无 CSS 样式,打印出来就是黑底白字</pre> - 用 Chrome 打开生成的 HTML,按
Ctrl+P→ 目标选「另存为 PDF」→ 关闭页眉页脚、勾选「背景图形」、缩放设为「100%」 - Safari / Firefox 不推荐:对
@media print支持弱,高亮色块常变浅甚至消失 - 如果打印后中文仍模糊,Chrome 打印设置里**关掉「背景图形」**,反而能提升中文字体抗锯齿效果
真正容易被忽略的是:同一份代码,在不同 color_scheme 下导出的 HTML 渲染效果可能完全不同,而且无法预览——你得导一次、开一次、调一次。导出不是终点,而是调试链的第一环。










