pdf2htmlEX命令行参数大全：从基础到高级用法
项目地址: https://gitcode.com/gh_mirrors/pd/pdf2htmlEX 你是否在将PDF转换为HTML时遇到过格式错乱、文字丢失或文件体积臃肿的问题？作为一款专注于保留文本与格式的PDF转HTML工具，pdf2htmlEX提供了丰富的命令行参数来满足不同场景需求。本文将系统梳理其10大类60+参数，通过实例解析帮助你掌握从基础转换到高级优化的全流程技巧，让PDF转HTML效率提升300%。
基础转换参数
核心输入输出
pdf2htmlEX input.pdf output.html # 基础转换
pdf2htmlEX --first-page 3 --last-page 10 input.pdf # 转换第3-10页
| 参数 | 缩写 | 类型 | 默认值 | 说明 |
|---|---|---|---|---|
| --first-page | -f | int | 1 | 起始转换页码 |
| --last-page | -l | int | 最大页数 | 结束转换页码 |
页面尺寸控制
pdf2htmlEX --fit-width 1024 input.pdf # 自适应宽度为1024px
pdf2htmlEX --zoom 1.5 input.pdf # 150%缩放比例
关键参数解析：
--fit-width <fp>: 自动缩放使页面宽度适配指定像素值--fit-height <fp>: 类似fit-width但适配高度--use-cropbox: 使用PDF的CropBox而非MediaBox（默认）裁剪区域--hdpi <fp>/--vdpi <fp>: 图像水平/垂直分辨率（默认144 DPI）
内容嵌入与拆分
资源嵌入控制
pdf2htmlEX --embed cfijo input.pdf # 紧凑写法
pdf2htmlEX --embed-css 0 --embed-font 1 input.pdf # 单独控制
嵌入参数组合说明
小写字母表示不嵌入，大写表示强制嵌入。例如--embed CfI表示：
- C: 嵌入CSS
- f: 不嵌入字体
- I: 嵌入图像
文件拆分策略
pdf2htmlEX --split-pages 1 --page-filename "page_%d.html" input.pdf
当启用--split-pages 1时，会生成：
- 主HTML文件（含导航）
- 每页独立HTML（默认命名
input%d.page） - 共享CSS文件（默认
input.css）
字体处理高级参数
字体嵌入与转换
pdf2htmlEX --font-format woff --decompose-ligature 1 input.pdf
核心字体参数矩阵：
| 参数 | 功能 | 适用场景 |
|---|---|---|
| --font-format | 字体输出格式(ttf/otf/woff/svg) | 兼容性需求 |
| --decompose-ligature | 分解连字(fi→fi) | 文本复制需求 |
| --override-fstype | 清除字体嵌入限制位 | 商业PDF转换 |
| --process-type3 | 转换Type3字体(实验性) | 特殊字体渲染 |
字体优化技巧
pdf2htmlEX --auto-hint 1 --stretch-narrow-glyph 1 input.pdf
--auto-hint: 为无hint的字体自动添加提示信息--stretch-narrow-glyph: 拉伸窄字符而非填充间距--squeeze-wide-glyph: 压缩宽字符而非截断（默认启用）
文本渲染优化
文本布局控制
pdf2htmlEX --heps 0.5 --veps 0.5 --space-threshold 0.2 input.pdf
关键阈值参数：
--heps <fp>/--veps <fp>: 水平/垂直文本合并阈值（默认1.0px）--space-threshold <fp>: 单词间距阈值（默认0.125em）--font-size-multiplier: 字体大小乘数（默认4.0，增大提高精度）
文本可见性修复
pdf2htmlEX --correct-text-visibility 1 input.pdf
此参数启用复杂的文本可见性检测算法，解决以下问题：
图像与背景处理
背景图像控制
pdf2htmlEX --bg-format svg --svg-node-count-limit 5000 input.pdf
图像格式选择指南：
- PNG: 线条图、文字密集页面（默认）
- JPG: 照片类图像（需平衡质量与体积）
- SVG: 矢量图形（适合无损缩放，但节点数限制
--svg-node-count-limit）
性能优化参数
pdf2htmlEX --svg-embed-bitmap 0 --tmp-file-size-limit 10240 input.pdf
--svg-embed-bitmap: SVG中嵌入位图（默认1），设为0可减小SVG体积--tmp-file-size-limit: 临时文件大小限制(KB)，-1为无限制
加密与权限处理
pdf2htmlEX --owner-password "secret" --no-drm 1 encrypted.pdf
| 参数 | 用途 | 风险提示 |
|---|---|---|
| --owner-password | 所有者密码 | 需合法获取权限 |
| --user-password | 用户密码 | 用于打开加密文档 |
| --no-drm | 覆盖文档DRM设置 | 可能违反版权协议 |
高级调试与优化
调试参数组合
pdf2htmlEX --debug 1 --proof 1 input.pdf
--debug: 输出详细处理日志--proof: 文本同时渲染在文本层和背景层，用于验证一致性
性能调优建议
企业级应用案例
学术论文转换方案
pdf2htmlEX --fit-width 800 --embed CFIJO --correct-text-visibility 1 \
--font-format woff2 --process-outline 1 paper.pdf
电子书优化配置
pdf2htmlEX --fit-width 768 --font-size-multiplier 5.0 --split-pages 1 \
--space-threshold 0.15 --decompose-ligature 1 ebook.pdf
参数速查清单
必记基础参数
-f/--first-page -l/--last-page --fit-width --embed
--font-format --split-pages --debug
危险参数警示
--no-drm: 仅用于合法授权文档--override-fstype: 可能涉及字体版权问题--process-type3: 实验性功能，可能导致性能问题
通过合理组合这些参数，pdf2htmlEX能够满足从简单转换到复杂出版需求的各类场景。建议先使用默认参数测试，再根据具体问题针对性调整优化参数。完整参数可通过pdf2htmlEX --help获取最新文档。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
