跳到主要内容
PDF4me API集成知识库扩展API 测试员博客

转变 HTML 到 PDF 使用 n8n 行动

PDF4me 转变 HTML 到 PDF 变换 HTML 将内容转化为高质量内容 PDF 通过文件 n8n 自动化工作流程。流程 HTML 通过文件 n8n 触发器、二进制数据、base64 字符串或公共 URL生成 PDF带有保存物 CSS 样式、嵌入式图像、字体、响应式布局和动态内容渲染。此解决方案非常适合网页归档、自动生成报告、电子邮件发送等。PDF 转换、发票创建、文档系统和内容发布工作流程都需要准确的信息。 HTML 专业渲染 PDF 输出和无缝集成。

相关博客文章(1)

设置​

添加 PDF4me “转变 HTML 到 PDF节点到您的 n8n 工作流程并配置所需参数。有关初始设置说明，请参阅我们的 n8n 集成指南。

先决条件：

  • PDF4me API 证书
  • n8n 工作流访问
Get Your API Key

配置：

  1. 添加 PDF4me 节点到工作流
  2. 选择“转换” HTML 到 PDF“ 行动
  3. 配置输入参数（见下文）
将 HTML 转换为 PDF

参数​

Convert 函数的完整参数列表 HTML 到 PDF 操作。配置这些参数以控制 HTML 到 PDF 转换。

重要的： 标有星号 (***) 的参数是必需的，必须提供这些参数才能使操作正常运行。

范围类型描述例子
输入数据类型***StringHTML 输入格式选择
• 选择您的格式 HTML 数据输入
• PDF4me 支持多种输入类型，以提高灵活性。
• 选项：二进制数据、Base64 字符串、 HTML 代码，或 URL		Binary Data
输入二进制字段Binary二进制 HTML 文件输入 （二进制数据必填）
• 参考 HTML 来自前一个文件 n8n 节点或文件上传
• PDF4me 二进制进程 HTML 文件自动格式检测
• 当输入数据类型为“二进制数据”时为必填项		{{ $binary.data }}
Base64 HTML 内容StringBase64 编码 HTML 输入 （如果是 Base64 字符串则为必填项）
• 提供 HTML 内容以 base64 编码字符串的形式呈现
• PDF4me 自动解码和处理 HTML 内容
• 当输入数据类型为“Base64 字符串”时为必填项		PGh0bWw+
HTML 代码String生的 HTML 代码输入 （如果使用 HTML 代码则为必填项）
• 写入原始数据 HTML 手动编写代码
• 将自动转换为 base64 格式
• 当输入数据类型为“HTML代码”时为必填项		<html>Hello</html>
HTML URLString民众 HTML URL 输入 （如果是 URL，则为必填项）
• 提供公开/开放权限 URL 到 HTML 文件
• PDF4me 从……下载并处理文件 URL
• 当输入数据类型为“URL”时为必填项		https://abc.com/page.html
HTML 文件名***StringHTML 输入文件名
• 指定输入名称 HTML 文件
• 必须包含正确的文件扩展名（.html、.htm）
• PDF4me 用于格式检测和处理		document.html
索引文件路径***String索引文件参考
• 指定主目录的路径 HTML 文件（index.html）
• 为了 HTML 包含多个文件的项目
• PDF4me 将其用作渲染的入口点		index.html
输出文件名***StringPDF 输出文件名
• 指定生成的文件的名称 PDF 文件
• 必须包含 .pdf 扩展名
• PDF4me 确保唯一命名和格式验证		output.pdf
二进制数据输出名称***String二进制数据输出映射
• 定义用于访问生成的数据的变量名。 PDF 二进制数据
• 用于后续工作流程操作
• 对工作流程自动化至关重要		data

高级选项​

以下参数可在“高级选项”部分中找到，且为可选参数：

范围类型描述例子
布局String页面方向设置
• 选择纵向（竖屏）或横向（横屏）模式
• 影响 PDF 页面尺寸和内容流
• 默认设置为竖屏		Portrait
格式String页面尺寸格式
• 选择纸张尺寸格式 PDF 一代
• 支持标准格式：A系列、法律文件、小报
• 默认尺寸为 A4		A4
规模小数内容缩放因子
• 控制内容的大小 PDF
• 1.0 代表 100% 原始尺寸
• 在调整尺寸的同时保持质量		0.8
顶部边际String顶部边距配置
• 设置上边距（像素、英寸或厘米）
• 确保与顶部边缘保持一致的间距
• 默认值为 40 像素		40px
底边距String底部边距配置
• 配置底部间距以获得合适的页面布局
• 防止内容被截断
• 默认值为 40 像素		40px
左边距String左边距设置
• 定义内容定位的左边距空间
• 保持一致的左对齐
• 默认值为 40 像素		40px
右边距String右侧边距配置
• 设置右边距以控制内容宽度
• 防止文本被截断
• 默认值为 40 像素		40px
打印背景Boolean背景打印控制
• 启用或禁用背景元素（颜色、图案、图像）
• 确保准确的视觉呈现
• 默认值为 false		false
显示页眉页脚Boolean页眉/页脚可见性
• 控制页面页眉和页脚的包含
• 包括页码、标题、时间戳
• 默认值为 false		false

输出​

输出参数​

范围类型描述例子
文件名StringPDF4me 生成的 PDF 文件名 - 成功生成的完整文件名 PDF 文档必须具有正确的 .pdf 扩展名。 PDF4me 确保唯一命名并验证文件格式合规性，以便与下游流程无缝集成。output.pdf
mimeTypeStringPDF4me MIME 类型标识符 - 标准化 MIME 生成的类型 PDF 文件，始终设置为 application/pdf 经过 PDF4me的转换引擎。这确保了所有系统和应用程序都能正确处理和识别文件。application/pdf
文件大小数字PDF4me PDF 文件大小（字节） 生成的确切大小 PDF 文件大小以字节为单位，由 PDF4me 用于存储规划、带宽优化和文件传输监控。对企业文档管理和工作流自动化至关重要。30063
成功BooleanPDF4me 转换状态指示器 - 布尔标志，指示成功或失败 HTML-到-PDF 转换过程。 PDF4me 返回 true 为了成功转化和 false 针对任何错误，在自动化工作流程中实现强大的错误处理能力。true
信息StringPDF4me 转换状态消息 - 描述结果的说明信息 HTML-到-PDF 转换过程。 PDF4me 为转换成功提供清晰的状态消息，并为故障排除提供详细的错误信息。HTML converted to PDF successfully

N8N 行动反应​

这 PDF4me 转变 HTML 到 PDF API 返回的结果可以以多种格式查看。请选择最符合您需求的视图：

JSON 回复格式

原始 JSON 来自……的回应 API：

{
  "fileName": "output.pdf",
  "mimeType": "application/pdf",
  "fileSize": 30063,
  "success": true,
  "message": "HTML converted to PDF successfully"
}

用例​

网络内容存档和文档​

  • 将动态网页、在线文章和数字内容转换为 PDF 格式，以便长期存档、合规文档和法律记录保存。
  • 将基于 Web 的报告、仪表板和分析页面转换为 PDF 格式，以便离线访问、共享和演示。
  • 通过将 HTML 内容转换为 PDF 格式，存档网站快照和在线文档，以便进行历史保存和参考。

电子邮件营销和数字通信​

  • 将 HTML 电子邮件模板和新闻简报转换为 PDF 格式，以便打印分发、离线共享，并符合电子邮件营销法规。
  • 处理基于网络的表单和调查，将 HTML 提交内容转换为 PDF 格式，以便进行记录、分析和合规性审查。
  • 生成基于网络的目录、宣传册和促销材料的PDF版本，用于线下分发和印刷营销活动。

Web应用程序和系统集成​

  • 将基于 Web 的报告和数据可视化转换为 PDF 格式，以实现报告自动生成、系统集成和商业智能工作流程。
  • 通过将 HTML 内容转换为 PDF 格式，处理基于网络的发票、收据和财务文档，以便会计系统和财务记录保存。
  • 生成基于网络的合同、协议和法律文件的 PDF 版本，用于数字签名、存档和法律合规性。

获取帮助​

n8n Integration Guiden8n SampleGetting Started