Python para criar arquivos PDF

Como criar arquivos PDF em Python

This article was translated from English: Does it need improvement?
Translated
View the article in English

Crie arquivos PDF em Python usando a biblioteca IronPDF , convertendo strings HTML, arquivos HTML ou URLs em documentos PDF com apenas algumas linhas de código. O IronPDF lida automaticamente com a renderização, a formatação e os recursos de segurança.

Início rápido: Criar PDF em Python

:title=Quickstart
# 1. Install IronPDF: pip install ironpdf
# 2. Import the library
from ironpdf import *
# 3. Create renderer
renderer = ChromePdfRenderer()
# 4. Convert HTML to PDF
pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")
# 5. Save the PDF
pdf.SaveAs("output.pdf")
:title=Quickstart
# 1. Install IronPDF: pip install ironpdf
# 2. Import the library
from ironpdf import *
# 3. Create renderer
renderer = ChromePdfRenderer()
# 4. Convert HTML to PDF
pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")
# 5. Save the PDF
pdf.SaveAs("output.pdf")
PYTHON

A automatização da criação de PDFs em Python permite que os desenvolvedores gerem PDFs diretamente em seus aplicativos. Essa funcionalidade se mostra útil para gerar faturas, relatórios ou outros tipos de documentos conforme necessário.

Este guia prático aborda a utilização do IronPDF para criar arquivos PDF programaticamente em scripts Python.

O que é a biblioteca IronPDF for Python?

IronPDF é uma biblioteca Python projetada para criar documentos PDF a partir de HTML. Suas APIs facilitam a geração e personalização de PDFs com diversos recursos, incluindo:

  1. Adicionar texto, imagens e outros tipos de conteúdo
  2. Escolher fontes, cores e controlar o layout e a formatação do documento.

O IronPDF pode ser integrado a aplicações .NET , Java e Python , permitindo a geração de PDFs em múltiplas plataformas.

Além da geração de PDFs, o IronPDF oferece recursos adicionais. Isso inclui conversão de formato de arquivo, extração de texto e dados de PDFs e a capacidade de proteger PDFs por meio de criptografia com senha. Para casos de uso avançados, explore como mesclar vários PDFs , compactar arquivos PDF ou preencher formulários PDF programaticamente.

Quais são os passos para criar um documento PDF em um script Python?

Quais são os pré-requisitos?

Para usar o IronPDF for Python, certifique-se de que seu computador tenha o seguinte software instalado:

  1. .NET 6.0 SDK: Necessário, pois o IronPDF Python depende da biblioteca IronPDF .NET . Faça o download no site oficial da Microsoft .
  2. Python: Baixe e instale o Python 3.x em https://www.python.org/downloads/. Selecione a opção para adicionar o Python ao PATH durante a instalação.
  3. Pip: Geralmente incluído no Python 3.4+. Verifique a instalação ou instale separadamente, se necessário.
  4. IronPDF Library: Instale usando o pip com o comando abaixo:
pip install ironpdf

ObserveEm alguns sistemas, o Python 2.x ainda pode ser a versão padrão. Nesses casos, talvez seja necessário usar explicitamente o comando pip3 em vez de pip para garantir que você esteja usando o Pip for Python 3. Se você encontrar erros de instalação, consulte nosso guia de solução de problemas para erros de sistema operacional .

Que configuração de código é necessária antes de criar PDFs?

Primeiro, adicione a seguinte instrução no início do seu script Python:

# Import statement for IronPDF for Python
from ironpdf import *
# Import statement for IronPDF for Python
from ironpdf import *
PYTHON

Em seguida, configure o IronPDF com uma chave de licença válida, atribuindo a chave de licença ao atributo LicenseKey da classe License (antes de qualquer outra linha de código). Para obter instruções detalhadas sobre como implementar chaves de licença em seu projeto, visite nosso guia de configuração de chaves de licença .

# Apply your license key
License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
# Apply your license key
License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
PYTHON

ObservePara criar PDFs sem marcas d'água, você precisará de uma chave de licença válida. Purchase a license key or obtain a free trial license key. Caso contrário, prossiga para a próxima etapa para gerar novos documentos PDF gratuitos com marcas d'água.

Como faço para converter uma string HTML em um documento PDF?

Qual método devo usar para converter uma string HTML?

Use o método RenderHtmlAsPdf para gerar um novo documento PDF a partir de uma string HTML. Este método suporta estilização CSS, execução de JavaScript e fontes personalizadas.

Forneça a marcação HTML como parâmetro para o método RenderHtmlAsPdf. O IronPDF realizará a conversão, resultando em uma instância PdfDocument.

# Instantiate Renderer
renderer = ChromePdfRenderer()

# Create a PDF from an HTML string using Python
pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1><p>This is an example HTML string.</p>")
# Instantiate Renderer
renderer = ChromePdfRenderer()

# Create a PDF from an HTML string using Python
pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1><p>This is an example HTML string.</p>")
PYTHON

Como faço para salvar o PDF gerado?

Após a string HTML ser convertida em um documento PDF, use o método SaveAs para salvar o PDF em um caminho no sistema local:

# Export to a file or Stream
pdf.SaveAs("htmlstring_to_pdf.pdf")
# Export to a file or Stream
pdf.SaveAs("htmlstring_to_pdf.pdf")
PYTHON

Um arquivo PDF chamado "htmlstring_to_pdf.pdf" será criado, preservando o conteúdo da string HTML original. Para técnicas mais avançadas de renderização HTML, incluindo o trabalho com layouts complexos e frameworks JavaScript , consulte nosso tutorial completo de HTML para PDF .

Como gerar um PDF a partir de um arquivo HTML em Python?

Qual é o processo para converter arquivos HTML locais?

Para gerar um documento PDF a partir de um arquivo HTML armazenado localmente em Python, siga o código abaixo. O método RenderHtmlFileAsPdf fornece uma maneira direta de converter documentos HTML existentes:

# Instantiate Renderer
renderer = ChromePdfRenderer()

# Create a PDF from an existing HTML file using Python
pdf = renderer.RenderHtmlFileAsPdf("example.html")

# Export to a file or Stream
pdf.SaveAs("htmlfile_to_pdf.pdf")
# Instantiate Renderer
renderer = ChromePdfRenderer()

# Create a PDF from an existing HTML file using Python
pdf = renderer.RenderHtmlFileAsPdf("example.html")

# Export to a file or Stream
pdf.SaveAs("htmlfile_to_pdf.pdf")
PYTHON

Por que o IronPDF preserva a formatação HTML?

No código acima, o método RenderHtmlFileAsPdf cria um documento PDF a partir de um arquivo HTML. Forneça uma string ou um caminho especificando a localização do arquivo HTML no sistema de arquivos.

O IronPDF renderiza os elementos HTML, incluindo qualquer CSS e JavaScript associados, exatamente como um navegador da web faria. Isso garante uma representação precisa do conteúdo no PDF resultante. A biblioteca oferece suporte a padrões web modernos, incluindo CSS3, HTML5 e frameworks JavaScript , tornando-a ideal para converter documentos web complexos para o formato PDF.

Use o método SaveAs para salvar o PDF gerado em um local específico do seu sistema, semelhante ao exemplo anterior.

Como criar um PDF a partir de uma URL em Python?

Qual método converte páginas da web em PDF?

Para criar um documento PDF a partir de uma página da web em Python, use o método RenderUrlAsPdf. Forneça o URL da página web desejada como argumento para o método:

# Instantiate Renderer
renderer = ChromePdfRenderer()

# Create a PDF from a URL or local file path
pdf = renderer.RenderUrlAsPdf("https://ironpdf.com")

# Export to a file or Stream
pdf.SaveAs("url.pdf")
# Instantiate Renderer
renderer = ChromePdfRenderer()

# Create a PDF from a URL or local file path
pdf = renderer.RenderUrlAsPdf("https://ironpdf.com")

# Export to a file or Stream
pdf.SaveAs("url.pdf")
PYTHON

O recurso de renderização de URLs oferece suporte a tecnologias web modernas, incluindo conteúdo JavaScript dinâmico, chamadas AJAX e layouts responsivos. O IronPDF aguarda o carregamento completo da página antes de realizar a conversão, garantindo que todo o conteúdo seja capturado com precisão.

Onde posso encontrar mais exemplos de conversão de URL?

Mais informações sobre como converter páginas da Web em PDFs estão disponíveis na página de exemplo de código para PDF . Para sites que exigem autenticação, consulte nosso guia sobre logins em sites e sistemas .

Como posso personalizar as opções de formatação de PDF?

Quais configurações posso modificar em RenderingOptions?

Para personalizar a formatação dos seus arquivos PDF, use o atributo RenderingOptions. Esta classe oferece diversas configurações ajustáveis ​​para que você possa obter o layout e a aparência desejados em seus documentos PDF. As configurações incluem orientação da página, tamanho da página, tamanho da margem e muito mais. Defina os atributos disponíveis em RenderingOptions para gerar documentos PDF com as configurações desejadas. Consulte este exemplo de código para obter mais informações sobre como usar o RenderingOptions.

As opções de personalização adicionais incluem:

  • Definir margens de página personalizadas
  • Configurar as orientações retrato e paisagem
  • Definição de tamanhos de página PDF personalizados
  • Gerenciar números de página e quebras de página

Como proteger arquivos PDF com senhas?

Qual é o processo para adicionar proteção por senha?

Para adicionar proteção por senha a arquivos PDF, use o atributo SecuritySettings do objeto PdfDocument. Acesse o atributo SecuritySettings e atribua uma senha ao atributo UserPassword, especificada como uma string. Para recursos de segurança mais avançados, incluindo criptografia e assinaturas digitais, visite nossa página de exemplos de segurança e metadados .

Por exemplo, considere proteger o documento PDF criado no exemplo "URL para PDF":

# Set user password for PDF document security
pdf.SecuritySettings.UserPassword = "sharable"

# Configure additional security settings
pdf.SecuritySettings.OwnerPassword = "admin123"
pdf.SecuritySettings.AllowUserPrinting = True
pdf.SecuritySettings.AllowUserCopyPasteContent = False

# Save the password-protected PDF
pdf.SaveAs("protected.pdf")
# Set user password for PDF document security
pdf.SecuritySettings.UserPassword = "sharable"

# Configure additional security settings
pdf.SecuritySettings.OwnerPassword = "admin123"
pdf.SecuritySettings.AllowUserPrinting = True
pdf.SecuritySettings.AllowUserCopyPasteContent = False

# Save the password-protected PDF
pdf.SaveAs("protected.pdf")
PYTHON

Como funciona a proteção por senha na prática?

O arquivo PDF está protegido por senha. Ao tentar abrir o arquivo, será exibida uma solicitação de senha. Digite a senha correta para acessar o conteúdo do arquivo PDF. A senha de proprietário concede privilégios administrativos adicionais, permitindo que você modifique as configurações de segurança posteriormente.

Leia mais informações sobre configurações adicionais de segurança e metadados e explore os recursos de criptografia e descriptografia de PDFs .

Qual é o código-fonte completo?

O arquivo fonte completo para este tutorial está incluído abaixo:

# Import statement for IronPDF for Python
from ironpdf import *

# Apply your license key
License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"

# Instantiate Renderer
renderer = ChromePdfRenderer()
# Create a PDF from a HTML string using Python
pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1><p>This is an example HTML string.</p>")
# Export to a file or Stream
pdf.SaveAs("htmlstring_to_pdf.pdf")

# Instantiate Renderer
renderer = ChromePdfRenderer()
# Create a PDF from an existing HTML file using Python
pdf = renderer.RenderHtmlFileAsPdf("example.html")
# Export to a file or Stream
pdf.SaveAs("htmlfile_to_pdf.pdf")

# Instantiate Renderer
renderer = ChromePdfRenderer()
# Create a PDF from a URL or local file path
pdf = renderer.RenderUrlAsPdf("https://ironpdf.com")
# Export to a file or Stream
pdf.SaveAs("url.pdf")

# Set user password for PDF document security
pdf.SecuritySettings.UserPassword = "sharable"
# Save the password-protected PDF
pdf.SaveAs("protected.pdf")
# Import statement for IronPDF for Python
from ironpdf import *

# Apply your license key
License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"

# Instantiate Renderer
renderer = ChromePdfRenderer()
# Create a PDF from a HTML string using Python
pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1><p>This is an example HTML string.</p>")
# Export to a file or Stream
pdf.SaveAs("htmlstring_to_pdf.pdf")

# Instantiate Renderer
renderer = ChromePdfRenderer()
# Create a PDF from an existing HTML file using Python
pdf = renderer.RenderHtmlFileAsPdf("example.html")
# Export to a file or Stream
pdf.SaveAs("htmlfile_to_pdf.pdf")

# Instantiate Renderer
renderer = ChromePdfRenderer()
# Create a PDF from a URL or local file path
pdf = renderer.RenderUrlAsPdf("https://ironpdf.com")
# Export to a file or Stream
pdf.SaveAs("url.pdf")

# Set user password for PDF document security
pdf.SecuritySettings.UserPassword = "sharable"
# Save the password-protected PDF
pdf.SaveAs("protected.pdf")
PYTHON

O IronPDF renderiza com precisão todas as imagens e textos, preservando sua formatação. Elementos interativos, como botões, permanecem clicáveis, e as caixas de texto mantêm sua capacidade de edição dentro do arquivo PDF gerado.

Quais são os principais pontos a serem destacados?

Neste guia prático, exploramos o processo de criação de PDFs em Python usando a biblioteca IronPDF . Com o IronPDF, os desenvolvedores podem gerar e manipular documentos PDF de forma eficiente.

A biblioteca oferece uma API que simplifica a criação de PDFs a partir de diversas fontes, incluindo arquivos HTML, documentos XML, URLs e muito mais. Seja para gerar relatórios, faturas ou qualquer outro tipo de documento, o IronPDF oferece as ferramentas necessárias para realizar a tarefa.

IronPDF é uma biblioteca comercial e requer uma licença válida. Possui uma licença comercial que começa em $799. Para avaliar suas capacidades em um ambiente de produção, você pode aproveitar a chave de licença de avaliação gratuita.

Faça o download do software.

Perguntas frequentes

Como faço para instalar a biblioteca Python para criar arquivos PDF?

Instale o IronPDF usando o pip com o comando: `pip install ironpdf`. Certifique-se de ter o Python 3.x e o SDK do .NET 6.0 instalados em seu sistema, pois o IronPDF for Python depende da biblioteca IronPDF for .NET.

Qual é a maneira mais simples de converter HTML para PDF em Python?

A maneira mais simples é usando o método RenderHtmlAsPdf do IronPDF. Basta importar o IronPDF, criar uma instância de ChromePdfRenderer e usar renderer.RenderHtmlAsPdf('Seu conteúdo HTML') para converter strings HTML diretamente em documentos PDF.

Posso criar PDFs a partir de arquivos HTML existentes?

Sim, o IronPDF oferece o método RenderHtmlFileAsPdf, que permite gerar arquivos PDF diretamente a partir de arquivos HTML armazenados no seu sistema, mantendo toda a formatação e estilos.

Como posso converter um URL de página web em PDF usando Python?

Utilize o método RenderUrlAsPdf do IronPDF para criar arquivos PDF a partir de qualquer URL. A biblioteca renderizará a página da web exatamente como ela aparece em um navegador e a converterá em um documento PDF.

Quais são os pré-requisitos para criar PDFs em Python?

Você precisa do Python 3.x, do gerenciador de pacotes pip, do SDK do .NET 6.0 (já que o IronPDF for Python depende da biblioteca .NET) e da biblioteca IronPDF instalada via pip.

Posso adicionar recursos de segurança aos meus PDFs gerados?

Sim, o IronPDF permite exportar arquivos PDF protegidos por senha e proteger seus documentos por meio de criptografia de senha, garantindo a proteção dos PDFs gerados.

Que tipos de conteúdo posso adicionar a PDFs?

Com o IronPDF, você pode adicionar texto, imagens e outros tipos de conteúdo aos seus PDFs. Você também pode personalizar fontes, cores e controlar o layout e a formatação do documento.

É possível mesclar ou compactar arquivos PDF programaticamente?

Sim, o IronPDF oferece recursos avançados além da geração básica de PDFs, incluindo a capacidade de mesclar vários PDFs, compactar arquivos PDF e preencher formulários PDF programaticamente.

Curtis Chau
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Leia mais
Pronto para começar?
Versão: 2026.3 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas?
executar um exemplo Veja seu HTML se transformar em um PDF.