1. IronPDF
2. 教程
3. HTML到PDF

HTML to PDF: Python

Curtis Chau

已更新:八月 20, 2025

Download IronPDF

• pip 下载

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Copy URL
• Email article

This article was translated from English: Does it need improvement?

Translated

View the article in English

本指南为 Python 开发者提供了逐步指导，详细说明如何利用 IronPDF 库将 HTML 内容转换为高质量的 PDF 格式（可移植文档格式）文件。

IronPDF is a comprehensive PDF converter and processing library that supports multiple programming languages, including .NET, Java, and Python programming languages. 本教程专注于在 Python 脚本中使用 IronPDF 将 HTML 内容转换为各种形式的文件或标记。

另一个专门教程是关于在 .NET 应用程序中转换 HTML 为 PDF。

---

class="main-content__segment-title">概述

class="hsg-featured-snippet">

如何在 Python 中将 HTML 转换为 PDF

1. 安装需要的 Python 库以进行 HTML 转 PDF 转换
2. 使用 RenderHtmlAsPdf 方法将 HTML 字符串转换为 PDF 文档
3. 直接从网站 URL 在 Python 中生成 PDF 文件
4. 使用 RenderHtmlFileAsPdf 方法将 HTML 文件转换为 PDF 文件
5. 将生成的 PDF 保存为新文件

---

class="main-content__segment-title">入门

。 ## 1. 安装 IronPDF PDF 库用于 Python 要为 Python 安装 IronPDF 库，可以使用流行的软件包管理器 pip。只需执行以下命令： ```shell :ProductInstall ```

提示要安装 IronPdf 的特定版本，请使用以下语法：`==2023.x.x`。 例如，你可以运行以下命令：

```shell pip install ironpdf==2023.x.x ```

请注意IronPDF for Python依赖于IronPDF .NET库，专门是.NET 6.0，作为其底层技术。 因此，您必须在计算机上安装[.NET 6.0 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/6.0)，以便使用IronPDF for Python。

---

class="main-content__segment-title">操作指南和代码示例

。 ## 2. 将 HTML 转换为 PDF 在接下来的部分中，我们将深入了解 IronPDF 的显著渲染能力，将 HTML 转换为 PDF。 PDF 文档渲染的主要组件是 `ChromePdfRenderer` 类。 此外，`PdfDocument` 类提供了一系列操作功能。 IronPDF 提供了可靠的方法来将 HTML 内容转换为 PDF 文档，适用于`三个关键场景`： - 将 HTML 字符串/标记转换为 PDF - 将 HTML 文件/压缩包转换为 PDF - 将网址转换为 PDF 此部分将简要概述每种使用情况，并附有附加资源以获取更多详细信息。 ### 2.1 导入 IronPDF 软件包。 要导入 IronPDF，请在源文件的开头包含以下导入语句，这些源文件将使用 IronPDF： ```python # Import statement for IronPDF for Python from ironpdf import * ``` ### 2.2 设置许可证密钥（可选） IronPDF for Python 是免费的，但它会为免费用户在 PDF 上添加平铺背景水印。

class="content-img-align-center">

class="center-image-wrapper">

class="content__image-caption">访问 许可页面 获取你的许可证密钥，并享受无水印的 PDF。

要使用 IronPDF 生成无水印的 PDF，需要向库提供一个有效的许可证密钥。 以下代码片段演示了如何使用许可证密钥配置库： ```python # Apply your license key License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01" ``` 确保在生成 PDF 文件或修改其内容之前已设置许可证密钥。 建议在任何其他代码行之前调用 `LicenseKey` 方法。 You can [purchase a license key](/python/licensing/) from our licensing page or contact us to [obtain a free trial license key](trial-license). ### 2.3 设置日志文件位置（可选） IronPDF 可以在与你的 Python 脚本相同的目录中生成一个名为 `Default.log` 的文本文件以记录日志消息。 如果你想自定义日志文件的名称和位置，可以使用以下代码片段设置 `LogFilePath` 属性： ```python # Set a log path Logger.EnableDebugging = True Logger.LogFilePath = "Custom.log" Logger.LoggingMode = Logger.LoggingModes.All ```

请注意`Logger.LogFilePath` 应在使用任何 PDF 转换和操作方法之前调用。

### 2.4 从 HTML 字符串创建 PDF `RenderHtmlAsPdf` 方法将 HTML 字符串转换为 PDF 格式的文档。 以下代码片段演示了如何从带有单个标题元素的 HTML 字符串生成 PDF 文件： ```python from ironpdf import * # Instantiate Renderer renderer = ChromePdfRenderer() # Create a PDF from a HTML string using Python pdf = renderer.RenderHtmlAsPdf("") # Export to a file or Stream pdf.SaveAs("output.pdf") ```

class="content-img-align-center">

class="center-image-wrapper">

class="content__image-caption">利用 RenderHtmlAsPdf 方法将 HTML 标记转换成 PDF 文件。此方法可使用所有符合 W3C 标准的 HTML 和 CSS 标记生成 PDF。

`RenderHtmlAsPdf` 方法以现代浏览器处理 HTML、CSS 和 JavaScript 的方式处理它们，确保内容渲染的准确性。此功能使得软件工程师能够创建与其网页浏览器版本相似的 PDF。 此外，`RenderHtmlAsPdf` 方法可以处理位于本地或网络文件夹中的外部资源，如图像、样式表和脚本。 以下示例演示了从 HTML 创建的 PDF 文档，其中引用了一个 CSS 文件和一个存储在 `assets` 文件夹中的图像： ```python from ironpdf import * html = """ """ renderer = ChromePdfRenderer() pdf = renderer.RenderHtmlAsPdf(html) pdf.SaveAs("output.pdf") ```

class="content-img-align-center">

class="center-image-wrapper">

class="content__image-caption">RenderHtmlAsPdf 方法能够渲染各种类型的 HTML 内容。如果它可以在 Chrome 中显示，那么 RenderHtmlAsPdf 将会渲染它！

此外，开发人员可以为 `RenderHtmlAsPdf` 方法提供第二个参数，允许他们指定一个基础路径来引用网页资产。该路径可以指向文件系统上的本地目录，甚至是一个 URL 路径。 要更好地理解如何使用 `RenderHtmlAsPdf` 方法，你可以参考[这个代码示例](/python/examples/using-html-to-create-a-pdf/)或查阅 API 参考页面以获取更详细的信息。 ### 2.5 从 URL 创建 PDF 要将网站网址转换为 PDF 文档，开发人员可以利用 IronPDF 提供的 `RenderUrlAsPdf` 方法。 这是一个示例，演示了如何将维基百科文章渲染为 PDF 内容。 ```python from ironpdf import * # Instantiate Renderer renderer = ChromePdfRenderer() # Create a PDF from a URL or local file path pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/PDF") # Export to a file or Stream pdf.SaveAs("url.pdf") ```

class="content-img-align-center">

class="center-image-wrapper">

有关更多信息，你可以参考[a code example](/python/examples/converting-a-url-to-a-pdf/)演示如何将网页转换成 PDF。 ### 2.6 从 HTML 文件创建 PDF IronPDF 提供了将 HTML 文件转换为 PDF 并存储在本地文件系统中的能力。 它将 HTML 内容直接渲染为其等效的 PDF 格式。 For a real-world demonstration of this functionality, the following code example showcases the conversion of an invoice HTML file. You can access the HTML markup of the invoice. 此 HTML 标记方便你的使用： ```html

Jonathan Neal

101 E. Chapman Ave
Orange, CA 92866

(800) 555-1234

Some Company
c/o Some Guy

Invoice #	101138
Date	January 1, 2012
Amount Due	$600.00

Item	Description	Rate	Quantity	Price
-Front End Consultation	Experience Review	$150.00	4	$600.00

+

Total	$600.00
Amount Paid	$0.00
Balance Due	$600.00

``` 假设我们有一个本地 HTML 文件以及其相关的 CSS 和 JavaScript 文件保存在一个名为 "invoices" 的文件夹中，我们可以使用 IronPDF 将示例 HTML 文件转换为 PDF，使用以下 Python 代码： ```python from ironpdf import * # Instantiate Renderer renderer = ChromePdfRenderer() # Create a PDF from an existing HTML file using Python pdf = renderer.RenderHtmlFileAsPdf("invoices/TestInvoice1.html") # Export to a file or Stream pdf.SaveAs("htmlfile_to_pdf.pdf") ``` 与将 HTML 字符串转换为 PDF 类似，IronPDF 自动解析示例 HTML 文件中的相对 URLs，确保任何引用的样式表和脚本被正确应用到生成的 PDF 文档中。 这确保了网页的视觉外观在 PDF 文件中准确再现。 ## 3.进一步阅读 通过深入我们的[代码示例](/python/examples/using-html-to-create-a-pdf/)部分来探索 IronPDF 的 HTML 到 PDF 渲染的广泛能力。 1. 阅读[这个代码示例](/python/examples/pdf-generation-settings/)以了解如何在转换过程中自定义PDF文档的外观。 2. Learn how to generate PDF files with personalized [headers and footers](/python/examples/html-headers-and-footers/), adjust [margin sizes](/python/examples/ironpdf-set-custom-margins/) and [page dimensions](/python/examples/custom-pdf-paper-size/), [add watermarks](/python/examples/pdf-watermarking/), and more. 3. Additionally, explore techniques for [extracting text](/python/examples/extract-pdf-text/), [optimizing file sizes](/python/examples/pdf-compression/), and programmatically [printing PDFs](/python/how-to/python-print-pdf/). *[下载](https://ironpdf.com/downloads/python-extract-text-from-pdf.zip)软件产品。*

Curtis Chau

  立即与工程团队聊天

技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外，Curtis 对物联网 (IoT) 有浓厚的兴趣，探索将硬件和软件集成的新方法。在空闲时间，他喜欢玩游戏和构建 Discord 机器人，将他对技术的热爱与创造力相结合。