HTML para PDF em C#: PdfSharp, QuestPDF, iText, Puppeteer ou API
Publicado em 4 min de leitura
A primeira decisão em C# não é qual biblioteca instalar, e sim que tipo de ferramenta você quer. Elas diferem no que você escreve (código, HTML ou um layout), no lugar onde o trabalho acontece (dentro do seu processo, em um navegador que você publica ou no servidor de outra pessoa) e no que você precisa manter atualizado. Este guia separa as opções por tipo. Nós fazemos uma delas, a API, então dizemos com franqueza onde ela não é a resposta certa.
As bibliotecas mudam recursos e licenças. Leia a documentação e a licença atuais de tudo o que você considerar; o texto abaixo descreve a abordagem de cada uma, não as letras miúdas.
Seis abordagens
| Abordagem | Exemplos | Você escreve | Atenção a |
|---|---|---|---|
| Desenhar por código | PdfSharp, MigraDoc | Desenho em posições que você escolhe (PdfSharp) ou um modelo de documento com texto e tabelas que fluem (MigraDoc), tudo em C#. | Não converte HTML por conta própria: o HTML precisa ser transformado nesse modelo por você ou por um complemento. |
| Um layout em C# | QuestPDF | Uma descrição fluente do documento em C#, com um motor de layout de verdade. | Não é HTML. A licença depende do porte e do tipo da sua empresa: leia os termos atuais. |
| HTML por uma biblioteca | iText com o seu complemento de HTML, pacotes baseados no HtmlRenderer | HTML e CSS, convertidos no seu processo. | O iText tem licença dupla (AGPL de código aberto ou comercial). O HtmlRenderer mira HTML 4.01 e CSS 2, então layout moderno, como flexbox, não é o que ele faz. |
| Um navegador que você roda | PuppeteerSharp, Playwright | HTML, CSS e JavaScript, renderizados pelo Chromium. | Você baixa e mantém atualizado um navegador, com a memória, o tempo de partida e o sandbox dele. |
| Um conversor antigo | wkhtmltopdf e seus wrappers (DinkToPdf, Rotativa) | HTML e CSS. | O projeto original está arquivado: sem mais correções. A própria documentação alerta contra HTML não confiável. |
| Uma API HTTP | rustedf.cloud | HTML e CSS, ou um template salvo, enviados com HttpClient. |
Os seus dados saem do seu servidor. Depende da rede, e o seu plano define os limites. |
Como escolher
Faça estas perguntas em ordem. O primeiro “sim” sincero costuma decidir.
A página precisa de JavaScript para existir? Um aplicativo de página única, um gráfico desenhado no navegador, uma página que se monta ao carregar. Só um navegador renderiza isso. O PuppeteerSharp ou o Playwright são a resposta, e a API não é.
O documento é montado em C# e não tem HTML? Faturas montadas a partir de objetos, etiquetas, ingressos. Uma biblioteca de layout como o QuestPDF ou uma de desenho como o PdfSharp serve, e nenhuma precisa de rede.
Os dados podem sair do seu servidor? Se uma norma ou um contrato diz que não, use algo que rode no seu processo ou em um navegador que você hospede. Uma chamada de API envia os dados do documento a um serviço.
Você já tem HTML? Uma view Razor, um template de e-mail, uma página feita para impressão. Então a escolha é entre um navegador e a API. O navegador tem todos os recursos da web e lhe custa a manutenção dele. A API não tem manutenção nenhuma e suporta as partes do HTML e do CSS que importam para o papel: páginas, tabelas que continuam entre páginas, cabeçalhos e rodapés.
Onde ele roda? Em um contêiner ou em uma função serverless, um Chromium aumenta a imagem e a partida a frio. Uma chamada HTTP não aumenta nenhuma das duas.
Como fica a versão com a API
using var response = await http.PostAsJsonAsync( "v1/render", new { html, title = "Fatura 2026-0042" }, cancellationToken);response.EnsureSuccessStatusCode();byte[] pdf = await response.Content.ReadAsByteArrayAsync(cancellationToken);Não há pacote para instalar nem arquivo nativo para publicar. O custo é a lista do que ela não
faz: sem JavaScript, sem @font-face nem @import, e imagens só como URLs data: ou arquivos
que você enviou. Envie antes o mesmo corpo para POST /v1/validate: ele diz o que o serviço não
conseguiu usar, sem PDF e sem crédito.
Para onde ir depois
- Um cliente tipado, novas tentativas e os erros a tratar: Como gerar PDF a partir de HTML em C# e ASP.NET Core.
- Páginas que já existem na web: Converter página web em PDF em C# sem navegador headless.
- Uma tabela que ocupa várias páginas, com totais e números de página: Gerador de relatório PDF em C#.
Leia HTML e CSS suportados antes de decidir: ele lista exatamente o que o renderizador suporta.
Continue lendo
Código e integrações
Gerar PDF no ASP.NET Core: MVC, Razor Pages e minimal APIs
Transforme uma view Razor em PDF no ASP.NET Core com uma chamada de API: renderizador de views, view pronta para impressão, action MVC e handler do Razor Pages.
3 min de leitura
Código e integrações
Converter página web em PDF em C# sem navegador headless
Busque uma página com HttpClient e transforme o HTML em PDF com uma chamada de API em C#. Quais páginas isso atende, quais não e como conferir antes de depender.
3 min de leitura
Código e integrações
Gerador de relatório PDF em C#: tabela paginada com totais
Monte um relatório em PDF em C# a partir de uma lista de objetos: tabela com cabeçalho repetido em cada página, total, número de página e contagem de páginas.
3 min de leitura
Código e integrações
Salvar PDF em C#: em disco, como download ou em blob storage
Salve o PDF devolvido por uma chamada de renderização em C#: grave em disco, envie como download no ASP.NET Core, guarde um link assinado ou suba para o storage.
2 min de leitura