Bibliotecas PDF gratuitas for .NET: custos ocultos e melhores alternativas em C#

O que "Gratuito" Realmente Significa em Bibliotecas PDF .NET?

Procure "PDF" no NuGet e você encontrará bibliotecas em cinco modelos de licenciamento, cada um com diferentes restrições para implantação em .NET:

MIT/Apache (genuinamente permissivo): PdfSharp. Use-o em aplicações comerciais, contêineres Docker, Funções Azure, AWS Lambda — sem restrições, sem limites de receita, sem divulgação de código-fonte. O problema: ele não pode converter HTML para PDF.

AGPL (armadilha copyleft):iText Core(anteriormente iTextSharp). Implante-o em qualquer aplicação acessível por rede — apps web, APIs REST, microsserviços — e você deve liberar todo o seu código-fonte sob AGPL. Empresas SaaS não têm isenção.

Licença baseada em receita:QuestPDFCommunity License. Grátis abaixo de $1M de receita bruta anual. Ultrapasse esse limite e você precisará de uma licença comercial. A transição não é gradual — é um precipício.

Abandonado:wkhtmltopdfe todos os wrappers .NET. Arquivado com CVEs não corrigidos com pontuação 9.8 Crítica. Zero manutenção de segurança. Um passivo em qualquer auditoria de conformidade.

Operacionalmente caro: MarionetistaAfiado e Playwright for .NET. Sem restrições de licenciamento, suporte completo a CSS moderno — mas você está gerenciando processos de navegador externos, downloads de Chromium e ciclo de vida de memória em produção.

Cada categoria cria diferentes riscos para implantações .NET. O restante deste artigo detalha esses riscos com código, números e dados do ecossistema NuGet.

Por que o Preço do iText é a Verdadeira História?

A maioria dos artigos sobre iText foca no ângulo da aplicação AGPL. Isso é abordado em outro lugar. A questão mais relevante para equipes .NET avaliando bibliotecas PDF é o que acontece quando você precisa de uma licença comercial.

Quais são as limitações doPdfSharppara implantações .NET?

PdfSharp é a exceção entre as bibliotecas gratuitas: licença MIT, mais de 34 milhões de downloads no NuGet, genuinamente permissiva para uso comercial. Sem limites de receita. Nenhuma divulgação de código-fonte.

A limitação é arquitetural.PdfSharpopera ao nível de coordenadas de PDF. Não há parser HTML, nenhum motor CSS, sem renderização DOM.

var document = new PdfDocument();
var page = document.AddPage();
var gfx = XGraphics.FromPdfPage(page);

// Every element needs manual coordinates
var titleFont = new XFont("Arial", 18, XFontStyleEx.Bold);
var bodyFont = new XFont("Arial", 10);

gfx.DrawString("INVOICE #2024-0847", titleFont, XBrushes.Black, 72, 72);
gfx.DrawString("Date: 2024-12-15", bodyFont, XBrushes.Gray, 72, 100);

// Table header - manual line drawing
gfx.DrawLine(XPens.Black, 72, 140, 540, 140);
gfx.DrawString("Item", bodyFont, XBrushes.Black, 72, 155);
gfx.DrawString("Qty", bodyFont, XBrushes.Black, 300, 155);
gfx.DrawString("Price", bodyFont, XBrushes.Black, 400, 155);
gfx.DrawLine(XPens.Black, 72, 170, 540, 170);

// Row data - every cell is a manual coordinate
gfx.DrawString("Annual License", bodyFont, XBrushes.Black, 72, 185);
gfx.DrawString("1", bodyFont, XBrushes.Black, 300, 185);
gfx.DrawString("$749.00", bodyFont, XBrushes.Black, 400, 185);

document.Save("invoice.pdf");

var document = new PdfDocument();
var page = document.AddPage();
var gfx = XGraphics.FromPdfPage(page);

// Every element needs manual coordinates
var titleFont = new XFont("Arial", 18, XFontStyleEx.Bold);
var bodyFont = new XFont("Arial", 10);

gfx.DrawString("INVOICE #2024-0847", titleFont, XBrushes.Black, 72, 72);
gfx.DrawString("Date: 2024-12-15", bodyFont, XBrushes.Gray, 72, 100);

// Table header - manual line drawing
gfx.DrawLine(XPens.Black, 72, 140, 540, 140);
gfx.DrawString("Item", bodyFont, XBrushes.Black, 72, 155);
gfx.DrawString("Qty", bodyFont, XBrushes.Black, 300, 155);
gfx.DrawString("Price", bodyFont, XBrushes.Black, 400, 155);
gfx.DrawLine(XPens.Black, 72, 170, 540, 170);

// Row data - every cell is a manual coordinate
gfx.DrawString("Annual License", bodyFont, XBrushes.Black, 72, 185);
gfx.DrawString("1", bodyFont, XBrushes.Black, 300, 185);
gfx.DrawString("$749.00", bodyFont, XBrushes.Black, 400, 185);

document.Save("invoice.pdf");

São 20 linhas para uma fatura de única linha sem estilo, sem layout responsivo, sem CSS. Agora imagine construir um relatório de conformidade de 15 páginas com dados dinâmicos, gráficos, e identidade visual corporativa.

Quando oQuestPDFdeixa de ser gratuito?

QuestPDF adotou uma abordagem de design diferente do PdfSharp: uma API fluente que se lê como uma descrição de layout em vez de matemática de coordenadas. O design da API é realmente bom.

Document.Create(container =>
{
    container.Page(page =>
    {
        page.Size(PageSizes.A4);
        page.Margin(2, Unit.Centimetre);

        page.Content().Column(column =>
        {
            column.Item().Text("Invoice #2024-0847").FontSize(18).Bold();
            column.Item().Table(table =>
            {
                table.ColumnsDefinition(columns =>
                {
                    columns.RelativeColumn(3);
                    columns.RelativeColumn(1);
                    columns.RelativeColumn(1);
                });

                table.Cell().Text("Item").Bold();
                table.Cell().Text("Qty").Bold();
                table.Cell().Text("Price").Bold();

                table.Cell().Text("Annual License");
                table.Cell().Text("1");
                table.Cell().Text("$749.00");
            });
        });
    });
}).GeneratePdf("invoice.pdf");

Document.Create(container =>
{
    container.Page(page =>
    {
        page.Size(PageSizes.A4);
        page.Margin(2, Unit.Centimetre);

        page.Content().Column(column =>
        {
            column.Item().Text("Invoice #2024-0847").FontSize(18).Bold();
            column.Item().Table(table =>
            {
                table.ColumnsDefinition(columns =>
                {
                    columns.RelativeColumn(3);
                    columns.RelativeColumn(1);
                    columns.RelativeColumn(1);
                });

                table.Cell().Text("Item").Bold();
                table.Cell().Text("Qty").Bold();
                table.Cell().Text("Price").Bold();

                table.Cell().Text("Annual License");
                table.Cell().Text("1");
                table.Cell().Text("$749.00");
            });
        });
    });
}).GeneratePdf("invoice.pdf");

Isso é mais expressivo do que o sistema de coordenadas do PdfSharp. Mas compartilha a mesma limitação fundamental: nenhuma renderização HTML.

Por que evitar owkhtmltopdfem qualquer implantação .NET?

Comecei este artigo com a CVE-2022-35583 por um motivo. Essa vulnerabilidade SSRF não é teórica — explorações de prova de conceito estão publicamente disponíveis e sendo ativamente usadas.

Qual é o Verdadeiro Custo Operacional do PuppeteerSharp?

Esta é a seção que a maioria dos artigos de 'biblioteca PDF gratuita' erra. MarionetistaAfiado e Playwright for .NET são tecnicamente excelentes — eles renderizam HTML através do Chromium real, suportando todos os recursos CSS e APIs JavaScript. Sem restrições de licença. Sem limites de receita.

O custo é operacional. É assim que a geração de PDF do MarionetistaAfiado em produção realmente é:

using PuppeteerSharp;

public class PuppeteerPdfService : IDisposable
{
    private IBrowser _browser;
    private readonly SemaphoreSlim _semaphore;
    private long _pdfCount = 0;

    public PuppeteerPdfService()
    {
        // Limit concurrent pages to prevent memory exhaustion
        _semaphore = new SemaphoreSlim(3, 3);
    }

    public async Task InitializeAsync()
    {
        // Step 1: Download Chromium binary (~280MB)
        var fetcher = new BrowserFetcher();
        await fetcher.DownloadAsync();

        // Step 2: Launch with production-hardened flags
        _browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true,
            Args = new[]
            {
                "--no-sandbox",              // Required in Docker
                "--disable-setuid-sandbox",  // Required in Docker
                "--disable-dev-shm-usage",   // Prevent /dev/shm exhaustion
                "--disable-gpu",
                "--no-zygote",
                "--single-process",
                "--disable-extensions",
                "--max_old_space_size=4096"
            },
            Timeout = 30000
        });
    }

    public async Task<byte[]> GeneratePdfAsync(string html)
    {
        await _semaphore.WaitAsync();
        IPage page = null;

        try
        {
            Interlocked.Increment(ref _pdfCount);
            page = await _browser.NewPageAsync();

            await page.SetContentAsync(html, new NavigationOptions
            {
                WaitUntil = new[] { WaitUntilNavigation.Networkidle0 },
                Timeout = 20000
            });

            var pdfBytes = await page.PdfAsync(new PdfOptions
            {
                Format = PaperFormat.A4,
                PrintBackground = true,
                MarginOptions = new MarginOptions
                {
                    Top = "20mm", Bottom = "20mm",
                    Left = "15mm", Right = "15mm"
                }
            });

            return pdfBytes;
        }
        finally
        {
            if (page != null)
            {
                try { await page.CloseAsync(); }
                catch { /* Disposal can hang — GitHub issue #1489 */ }
            }
            _semaphore.Release();
        }
    }

    // Restart browser periodically to reclaim leaked memory
    public async Task RecycleBrowserAsync()
    {
        var oldBrowser = _browser;
        await InitializeAsync();
        try { oldBrowser?.Dispose(); } catch { }
    }

    public void Dispose()
    {
        _browser?.Dispose();
        _semaphore?.Dispose();
    }
}

using PuppeteerSharp;

public class PuppeteerPdfService : IDisposable
{
    private IBrowser _browser;
    private readonly SemaphoreSlim _semaphore;
    private long _pdfCount = 0;

    public PuppeteerPdfService()
    {
        // Limit concurrent pages to prevent memory exhaustion
        _semaphore = new SemaphoreSlim(3, 3);
    }

    public async Task InitializeAsync()
    {
        // Step 1: Download Chromium binary (~280MB)
        var fetcher = new BrowserFetcher();
        await fetcher.DownloadAsync();

        // Step 2: Launch with production-hardened flags
        _browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true,
            Args = new[]
            {
                "--no-sandbox",              // Required in Docker
                "--disable-setuid-sandbox",  // Required in Docker
                "--disable-dev-shm-usage",   // Prevent /dev/shm exhaustion
                "--disable-gpu",
                "--no-zygote",
                "--single-process",
                "--disable-extensions",
                "--max_old_space_size=4096"
            },
            Timeout = 30000
        });
    }

    public async Task<byte[]> GeneratePdfAsync(string html)
    {
        await _semaphore.WaitAsync();
        IPage page = null;

        try
        {
            Interlocked.Increment(ref _pdfCount);
            page = await _browser.NewPageAsync();

            await page.SetContentAsync(html, new NavigationOptions
            {
                WaitUntil = new[] { WaitUntilNavigation.Networkidle0 },
                Timeout = 20000
            });

            var pdfBytes = await page.PdfAsync(new PdfOptions
            {
                Format = PaperFormat.A4,
                PrintBackground = true,
                MarginOptions = new MarginOptions
                {
                    Top = "20mm", Bottom = "20mm",
                    Left = "15mm", Right = "15mm"
                }
            });

            return pdfBytes;
        }
        finally
        {
            if (page != null)
            {
                try { await page.CloseAsync(); }
                catch { /* Disposal can hang — GitHub issue #1489 */ }
            }
            _semaphore.Release();
        }
    }

    // Restart browser periodically to reclaim leaked memory
    public async Task RecycleBrowserAsync()
    {
        var oldBrowser = _browser;
        await InitializeAsync();
        try { oldBrowser?.Dispose(); } catch { }
    }

    public void Dispose()
    {
        _browser?.Dispose();
        _semaphore?.Dispose();
    }
}

São mais de 80 linhas antes de gerar um único PDF. E ainda falta recuperação de erro, verificações de saúde, métricas e o temporizador de reciclagem de memória que os sistemas de produção precisam.

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 20;
renderer.RenderingOptions.MarginBottom = 20;

var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 20;
renderer.RenderingOptions.MarginBottom = 20;

var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");

Saúde do Ecossistema .NET: Comparação de Pacotes NuGet

Antes de escolher uma biblioteca, verifique a saúde do seu ecossistema NuGet. Cadeias de dependências, frequência de lançamento e tempo de resolução de problemas dizem mais do que listas de recursos:

Contagens altas de downloads em pacotes abandonados comoDinkToPdfrefletem adoção legada, não saúde atual. As mais de 300 issues abertas sem respostas contam a verdadeira história.

Para aplicações .NET 8 direcionadas ao net8.0 TFM: PdfSharp, QuestPDF,iText CoreeIronPDFoferecem suporte nativo. Wrapperswkhtmltopdfnão oferecem — espere erros de incompatibilidade de framework de destino DllNotFoundException e NU1202.

Matriz de Decisão

Se você precisa apenas de criação programática de PDF a partir de dados estruturados:PdfSharp(MIT, sem restrições) ouQuestPDF(melhor API, fique de olho no limite de receita).

Se você precisa de HTML-para-PDF com CSS moderno e não quer gerenciar a infraestrutura do navegador: IronPDF. Chromium incorporado gerencia o ciclo de vida do mecanismo de renderização. Preço publicado é uma fração do modelo de assinatura do iText.

Se você precisa de HTML-para-PDF e está confortável gerenciando processos de navegador: MarionetistaAfiado dá total controle. Orçamento para a sobrecarga operacional.

Se você está atualmente usandowkhtmltopdfou qualquer um de seus envelopes: Migre. A exposição de segurança por si só justifica o esforço — e a cada mês que você adia, a lista de CVEs permanece sem correção.