Categorias

Renderizador HTML para PDF

Renderiza um subconjunto de HTML em PDF

Converte HTML para PDF com renderizacao determinista.

Tags suportadas:

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

Modos:

  • Subconjunto (PDFKit)
  • Navegador (Puppeteer)

Exemplos de resultados

1 Exemplos

Exemplo: HTML Renderer

Amostra de PDF gerada automaticamente: Browser render mode sample

html-to-pdf-renderer-example1.pdf Ver arquivo
Ver parâmetros de entrada
{ "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

Fatos principais

Categoria
Document Tools
Tipos de entrada
textarea, file, text, select, checkbox, number
Tipo de saída
file
Cobertura de amostras
4
API disponível
Yes

Visão geral

O Renderizador HTML para PDF é uma ferramenta eficiente para converter conteúdos web, arquivos HTML ou URLs diretamente em documentos PDF profissionais, oferecendo modos de renderização via PDFKit ou Puppeteer para atender às suas necessidades de layout.

Quando usar

  • Quando precisar transformar relatórios ou páginas web em documentos PDF estáticos.
  • Ao converter arquivos HTML locais para um formato de arquivo portátil e padronizado.
  • Para gerar documentos com estilos personalizados usando CSS em modo de renderização de navegador.

Como funciona

  • Insira o código HTML, carregue um arquivo .html ou forneça a URL da página desejada.
  • Escolha o modo de renderização: 'Subset' para documentos simples ou 'Browser' para layouts complexos.
  • Ajuste as configurações de página, como margens, orientação e tamanho, para personalizar o resultado.
  • Clique em processar para gerar e baixar o seu arquivo PDF final.

Casos de uso

Conversão de faturas e recibos gerados via web para arquivamento em PDF.
Transformação de documentação técnica ou manuais em formato de leitura offline.
Criação de relatórios de dados formatados a partir de tabelas HTML.

Exemplos

1. Gerar PDF de Relatório Web

Desenvolvedor
Contexto
Preciso salvar uma página de dashboard interna como PDF para enviar por e-mail.
Problema
A página possui estilos complexos que precisam ser preservados no documento final.
Como usar
Utilize o modo 'Browser', insira a URL do dashboard e ajuste a orientação para paisagem.
Configuração de exemplo
renderMode: browser, landscape: true, printBackground: true
Resultado
Um PDF fiel ao layout original do dashboard, mantendo todas as cores e gráficos.

2. Converter Documentação Simples

Redator Técnico
Contexto
Tenho um arquivo HTML contendo apenas texto e listas que precisa ser convertido em um manual simples.
Problema
O arquivo é leve e não requer processamento pesado de navegador.
Como usar
Carregue o arquivo HTML e selecione o modo 'Subset' para uma conversão rápida e determinista.
Configuração de exemplo
renderMode: subset, pageSize: A4
Resultado
Um arquivo PDF limpo, leve e perfeitamente formatado para leitura.

Testar com amostras

xml, html, pdf

Hubs relacionados

FAQ

Quais tags HTML são suportadas?

A ferramenta suporta tags essenciais como p, h1-h6, ul/ol, table, img e code.

Qual a diferença entre os modos Subset e Browser?

O modo Subset (PDFKit) é ideal para documentos simples e rápidos, enquanto o modo Browser (Puppeteer) oferece suporte completo para CSS e renderização complexa.

Posso usar CSS personalizado?

Sim, no modo de renderização via navegador, você pode inserir seu próprio código CSS para estilizar o documento.

É possível definir margens no PDF?

Sim, você pode configurar manualmente as margens superior, inferior, esquerda e direita em milímetros.

O que significa o modo de espera (wait time)?

Permite adicionar um tempo de espera extra em milissegundos para garantir que todos os recursos da página sejam carregados antes da renderização.

Documentação da API

Ponto final da solicitação

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

Parâmetros da solicitação

Nome do parâmetro Tipo Requerido Descrição
htmlContent textarea Não -
htmlFile file (Upload necessário) Não -
url text Não -
baseUrl text Não -
cssContent textarea Não -
renderMode select Não -
pageSize select Não -
landscape checkbox Não -
printBackground checkbox Não -
scale number Não -
marginTop number Não -
marginBottom number Não -
marginLeft number Não -
marginRight number Não -
fontSize number Não -
lineHeight number Não -
mediaType select Não -
waitUntil select Não -
waitTime number Não -

Os parâmetros de tipo arquivo precisam ser carregados primeiro via POST /upload/html-to-pdf-renderer para obter filePath, depois filePath deve ser passado ao campo de arquivo correspondente.

Formato de resposta

{
  "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)"
}
Arquivo: Arquivo

Documentação de MCP

Adicione este ferramenta à sua configuração de servidor MCP:

{
  "mcpServers": {
    "elysiatools-html-to-pdf-renderer": {
      "name": "html-to-pdf-renderer",
      "description": "Renderiza um subconjunto de HTML em PDF",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=html-to-pdf-renderer",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Você pode encadear várias ferramentas, ex: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, máx 20 ferramentas.

Suporta links de arquivos URL ou codificação Base64 para parâmetros de arquivo.

Se você encontrar algum problema, por favor, entre em contato conosco em [email protected]