ironpress CLI完全指南:一条命令批量转换HTML与Markdown文档为PDF
ironpress CLI完全指南一条命令批量转换HTML与Markdown文档为PDF【免费下载链接】ironpressPure Rust PDF converter, no browser, no external dependencies. Supports HTML with inline CSS, Markdown, and document conversion with a built-in layout engine.项目地址: https://gitcode.com/gh_mirrors/ir/ironpressironpress CLI 是一款用纯 Rust 编写的 PDF 转换命令行工具它内置完整的布局引擎能把带内联 CSS 的 HTML 文件和 Markdown 文档直接转换为标准 PDF 1.4 文件。全程无需浏览器、无需 Node.js、无任何系统级外部依赖一个可执行文件即可在本地、CI 或构建脚本中完成 HTML 转 PDF 与 Markdown 转 PDF 任务。本指南带你从零安装到一条命令批量转换整个文档目录并覆盖页面尺寸、页眉页脚、本地图片与字体解析等全部常用选项。为什么选择 ironpress 做文档转换传统方案通常依赖 Headless Chrome 或 wkhtmltopdf部署复杂、内存占用高。ironpress 的核心卖点非常直接极速基准测试中简单 HTML 约 0.93ms/次每秒约 1080 份Markdown 约 7ms/次每秒约 143 份详见基准文件benches/conversion.rs零依赖部署cargo install之后只有一个二进制没有浏览器运行时可管理文档级排版原生支持 Flexbox、Grid、表格、多栏布局、page、页眉页脚安全默认值HTML 默认消毒自动移除脚本、iframe 和事件处理器排版能力字体子集化嵌入、核心 Unicode 覆盖、SVG 与 LaTeX 公式渲染一键安装 ironpress CLI安装只需要 Rust 工具链和一条命令cargo install ironpress验证是否安装成功ironpress --version如果网络受限也可以从源码构建仓库地址为 https://gitcode.com/gh_mirrors/ir/ironpress git clone https://gitcode.com/gh_mirrors/ir/ironpress cd ironpress cargo build --release所有命令行参数的解析逻辑都在src/cli.rs中实现二进制入口在src/bin/cli.rs想看帮助随时运行ironpress --help。转换第一个 PDF最小命令用法ironpress 的基本语法只有两个位置参数——输入文件和输出文件ironpress invoice.html invoice.pdf执行成功后PDF 会写入invoice.pdf终端同时输出一条invoice.html → invoice.pdf的完成提示。就这么简单一行命令完成 HTML 转 PDF。批量转换整个目录这正是 CLI 最实用的场景。用一行 shell 循环即可批量转换目录中所有 HTML 或 Markdown 文件mkdir -p out for f in docs/*.html; do ironpress $f out/$(basename ${f%.*}).pdf done for f in docs/*.md; do ironpress $f out/$(basename ${f%.*}).pdf done每个文件一次调用转换失败会打印诊断信息并返回非零退出码非常适合放进 CI 流水线。转换 Markdown 文档扩展名自动识别.md和.markdown结尾的文件会被自动识别为 Markdown直接转换即可ironpress release-notes.md release-notes.pdf⚠️ 一个小细节标准输入stdin模式始终按 HTML 解析。如果你的管道起点是 Markdown建议先落盘为临时.md文件再转换。页面设置尺寸、方向、边距、页眉页脚一组参数组合就能定义整套文档策略ironpress report.html report.pdf \ --page-size letter \ --landscape \ --margin 36 \ --header Quarterly report \ --footer Page {page} of {pages}常用选项速查表选项默认值说明--page-sizea4支持a4、letter、legal--landscape关横向页面--margin72统一边距PDF 点72 ≈ 1 英寸--header/--footer无页眉 / 页脚{page}、{pages}自动替换为页码--sanitizetrueHTML 消毒开关--compresstrueFlateDecode 压缩内容流--jpeg-quality95图片嵌入时的 JPEG 质量0–100--auto-resize-imagestrue自动缩放超大源图--image-dpi/--filter-dpi/--mask-dpi300源图 / 滤镜 / 遮罩的栅格化 DPI--background-raster-dpi192扁平化背景的栅格化 DPI--base-path无本地图片、import、font-face的解析根目录解析本地图片、CSS 与字体--base-path 的正确姿势出于安全考虑ironpress 默认拒绝访问本地文件。当文档引用了相对路径的图片、CSSimport或font-face时先用--base-path授权一个根目录ironpress templates/invoice.html invoice.pdf --base-path templates之后所有相对 URL 只会在该目录内解析路径穿越和符号链接逃逸都会被拒绝这是它作为服务器端转换工具时的重要安全边界。从管道读取 HTML--stdin 模式不需要先生成文件任何命令的输出都能直接转成 PDFprintf h1Hello/h1pWorld/p | ironpress --stdin output.pdf常见报错与排错清单现象原因与解决Unknown page size: tabloid只支持a4、letter、legal三种命名尺寸本地图片没渲染出来缺少--base-path本地文件默认不可访问Markdown 内容被当成 HTML文件扩展名不是.md/.markdown或走了 stdin 管道图片太大导致 PDF 体积膨胀调低--jpeg-quality或确认--auto-resize-images true想抓取远程资源发布的二进制不发起远程请求请在本地准备好资源任何无效参数、读文件失败或转换错误都会打印诊断并以非零状态码退出方便脚本判断。总结ironpress CLI 把文档转 PDF这件事压缩成了一条命令ironpress 输入 输出.pdf。它用纯 Rust 实现了布局引擎、字体整形、SVG 与公式渲染没有浏览器、没有外部依赖批量转换整个目录只需一个 for 循环。如果你正在为 CI、报表系统或文档站点找一个轻量可靠的 PDF 方案从cargo install ironpress开始五分钟就能跑通第一个 PDF。【免费下载链接】ironpressPure Rust PDF converter, no browser, no external dependencies. Supports HTML with inline CSS, Markdown, and document conversion with a built-in layout engine.项目地址: https://gitcode.com/gh_mirrors/ir/ironpress创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

2026年亚马逊PPC广告分析工具怎么选?5款主流工具横向测评

2026年亚马逊PPC广告分析工具怎么选?5款主流工具横向测评

做亚马逊的卖家都清楚,PPC广告是获取流量的核心手段,但广告数据越积越多后,一个现实问题摆在面前:每个广告组的ROI到底是多少?哪些词在亏钱、哪些词在赚钱? 亚马逊后台的"广告活动管理"报表虽然…

2026/11/14 3:08:53 阅读更多 →
Zrythm 插件与音源获取完全指南:LV2/VST 安装教程 + 免费插件新手清单

Zrythm 插件与音源获取完全指南:LV2/VST 安装教程 + 免费插件新手清单

Zrythm 插件与音源获取完全指南:LV2/VST 安装教程 免费插件新手清单 【免费下载链接】zrythm a highly automated and intuitive digital audio workstation - official mirror 项目地址: https://gitcode.com/gh_mirrors/zr/zrythm 刚写好一段旋律&#xf…

2026/11/14 16:56:21 阅读更多 →
remarkable_mouse 如何把平板变成鼠标?深入解析SSH传输evdev事件流

remarkable_mouse 如何把平板变成鼠标?深入解析SSH传输evdev事件流

remarkable_mouse 如何把平板变成鼠标?深入解析SSH传输evdev事件流 【免费下载链接】remarkable_mouse use your reMarkable as a graphics tablet 项目地址: https://gitcode.com/gh_mirrors/re/remarkable_mouse remarkable_mouse 是一个开源 Python 项目&…

2026/10/24 13:42:13 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/20 23:27:28 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/20 23:27:28 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/20 23:27:28 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/20 21:55:32 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/20 23:27:28 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/20 22:59:12 阅读更多 →

日新闻

周新闻

月新闻