分类

← View All Tools

HTML转PDF渲染器

将有限HTML子集渲染为PDF

使用确定性的子集渲染器将HTML转换为PDF。

支持标签：

  • p、h1-h6、ul/ol、table、img、code

模式：

  • 子集渲染（PDFKit）
  • 浏览器渲染（Puppeteer）

示例结果

1 个示例

示例：HTML Renderer

自动生成的PDF样例：Browser render mode sample

html-to-pdf-renderer-example1.pdf 查看文件
查看输入参数
{ "htmlContent": "<h1 style='color:#1f2937'>Browser Mode</h1><p>Sample layout.</p>", "cssContent": "body { font-family: Arial, sans-serif; }", "renderMode": "browser", "printBackground": true, "waitUntil": "load" }

Click to upload file or drag and drop file here

Maximum file size: 10MB Supported formats: text/html, application/xhtml+xml, text/plain

关键信息

分类
Document Tools
输入类型
textarea, file, text, select, checkbox, number
输出类型
file
样本覆盖
4
支持 API
Yes

概览

HTML转PDF渲染器是一款高效的文档转换工具，支持通过HTML代码、文件或URL地址，将网页内容精准渲染为PDF格式，并提供多种渲染模式以满足不同排版需求。

适用场景

  • •需要将网页文章或在线文档快速保存为离线PDF文件时。
  • •需要将自定义的HTML模板转换为标准格式的报告或发票时。
  • •需要对复杂的网页布局进行精确的打印预览和格式化输出时。

工作原理

  • •输入HTML内容、上传HTML文件或提供目标网页的URL。
  • •选择渲染模式，如使用轻量级的Subset模式或功能强大的Browser模式。
  • •根据需求调整页面尺寸、边距、缩放比例及打印背景等参数。
  • •点击转换按钮，系统将自动处理并生成可下载的PDF文件。

使用场景

将技术文档或博客文章转换为便于阅读和分享的PDF电子书。
将动态生成的HTML发票或订单页面批量转换为存档用的PDF文件。
通过自定义CSS样式，将网页内容转化为符合企业规范的PDF报告。

用户案例

1. 网页文章转PDF

内容创作者
背景原因
用户希望将一篇长篇技术博客保存为PDF，以便在没有网络的环境下阅读，并保留原有的排版风格。
解决问题
直接使用浏览器打印功能会导致页眉页脚杂乱，且无法自定义边距。
如何使用
输入博客URL，选择Browser渲染模式，设置页面尺寸为A4，并调整边距以获得最佳阅读体验。
示例配置
renderMode: browser, pageSize: A4, printBackground: true, marginTop: 20, marginBottom: 20
效果
生成了一份排版整洁、保留了代码高亮和图片布局的PDF文档。

2. HTML模板生成发票

财务人员
背景原因
财务系统导出了一个HTML格式的订单明细，需要将其转换为正式的PDF发票发送给客户。
解决问题
HTML文件在不同设备上显示不一致，需要统一的PDF格式进行归档。
如何使用
上传HTML文件，选择Subset模式以确保渲染速度，并设置合适的字体大小和行高。
示例配置
renderMode: subset, fontSize: 12, lineHeight: 1.5
效果
快速获得了一份格式规范、内容清晰的PDF发票文件。

用 Samples 测试

xml, html, pdf
大小写转换样本
不同命名约定之间的大小写转换测试样本
preferred input family xml,text
xml, text
Nginx 日志解析示例
用于测试 log-parser 工具的综合 Nginx 日志样本，包括访问日志和错误日志的各种格式和场景
preferred input family xml,text
xml, text
PDF示例
2026-02-01 到 2026-02-10 工具生成的PDF示例
title token pdf
text
Splunk 日志分析示例
全面的 Splunk 配置和查询示例，用于日志分析、监控和运营智能
preferred input family xml,text
xml, text

相关专题

XmlConvert工具专题
探索 32 个围绕 xml 的 convert 工作流工具，快速找到相近能力。
TextConvert工具专题
探索 80 个围绕 text 的 convert 工作流工具，快速找到相近能力。
PdfConvert工具专题
探索 28 个围绕 pdf 的 convert 工作流工具，快速找到相近能力。
HtmlConvert工具专题
探索 11 个围绕 html 的 convert 工作流工具，快速找到相近能力。

常见问题

支持哪些HTML标签？

主要支持 p、h1-h6、ul/ol、table、img 和 code 等常用标签。

Subset模式和Browser模式有什么区别？

Subset模式基于PDFKit，适合简单的文档结构；Browser模式基于Puppeteer，支持复杂的CSS样式和动态内容渲染。

可以自定义PDF的页面边距吗？

可以，您可以在设置中分别调整上、下、左、右四个方向的边距，单位为毫米。

转换后的PDF背景颜色会丢失吗？

您可以勾选“打印背景”选项，以确保网页中的背景颜色和图像在PDF中完整保留。

如何处理网页中的相对路径资源？

您可以在“基础URL”字段中输入资源所在的根路径，工具将自动补全图片或CSS的相对引用。

API 文档

请求端点

POST /zh/api/tools/html-to-pdf-renderer

请求参数

参数名 类型 必填 描述
htmlContent textarea 否 -
htmlFile file (需要先上传) 否 -
url text 否 -
baseUrl text 否 -
cssContent textarea 否 -
renderMode select 否 -
pageSize select 否 -
landscape checkbox 否 -
printBackground checkbox 否 -
scale number 否 -
marginTop number 否 -
marginBottom number 否 -
marginLeft number 否 -
marginRight number 否 -
fontSize number 否 -
lineHeight number 否 -
mediaType select 否 -
waitUntil select 否 -
waitTime number 否 -

文件类型参数需要先通过 POST /upload/html-to-pdf-renderer 上传获取 filePath，然后将 filePath 传递给对应的文件字段。

响应格式

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
文件: 文件

AI MCP 文档

将此工具添加到您的 MCP 服务器配置中： 

{
  "mcpServers": {
    "elysiatools-html-to-pdf-renderer": {
      "name": "html-to-pdf-renderer",
      "description": "将有限HTML子集渲染为PDF",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=html-to-pdf-renderer",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

你可以串联多个工具，比如：`https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`，最多20个。

支持 URL 文件链接或 Base64 编码作为文件参数。

如果遇见问题，请联系我们：[email protected]