rustedf.cloud
Menú

HTML a PDF en C#: PdfSharp, QuestPDF, iText, Puppeteer o una API

Publicado el 4 min de lectura

La primera decisión en C# no es qué biblioteca instalar, sino qué tipo de herramienta quieres. Se diferencian en lo que escribes (código, HTML o un diseño), en dónde ocurre el trabajo (dentro de tu proceso, en un navegador que despliegas o en el servidor de otra persona) y en lo que tienes que mantener actualizado. Esta guía ordena las opciones por tipo. Nosotros hacemos una de ellas, la API, así que decimos con claridad dónde no es la respuesta correcta.

Las bibliotecas cambian sus funciones y sus licencias. Lee la documentación y la licencia actuales de todo lo que consideres; lo que sigue describe el enfoque de cada una, no la letra pequeña.

Seis enfoques

Enfoque Ejemplos Tú escribes Ojo con
Dibujar con código PdfSharp, MigraDoc Dibujo en posiciones que eliges (PdfSharp) o un modelo de documento con texto y tablas que fluyen (MigraDoc), todo en C#. No convierte HTML por sí mismo: el HTML hay que pasarlo a ese modelo tú o con un complemento.
Un diseño en C# QuestPDF Una descripción fluida del documento en C#, con un motor de diseño de verdad. No es HTML. La licencia depende del tamaño y del tipo de tu empresa: lee los términos actuales.
HTML mediante una biblioteca iText con su complemento de HTML, paquetes basados en HtmlRenderer HTML y CSS, convertidos en tu proceso. iText tiene licencia dual (AGPL de código abierto o comercial). HtmlRenderer apunta a HTML 4.01 y CSS 2, así que el diseño moderno, como flexbox, no es lo suyo.
Un navegador que ejecutas PuppeteerSharp, Playwright HTML, CSS y JavaScript, renderizados por Chromium. Descargas y mantienes actualizado un navegador, con su memoria, su tiempo de arranque y su sandbox.
Un conversor antiguo wkhtmltopdf y sus envoltorios (DinkToPdf, Rotativa) HTML y CSS. El proyecto original está archivado: sin más correcciones. Su propia documentación advierte contra el HTML no fiable.
Una API HTTP rustedf.cloud HTML y CSS, o una plantilla guardada, enviados con HttpClient. Tus datos salen de tu servidor. Necesita la red, y tu plan fija los límites.

Cómo elegir

Hazte estas preguntas en orden. El primer “sí” sincero suele decidir.

¿La página necesita JavaScript para existir? Una aplicación de una sola página, un gráfico dibujado en el navegador, una página que se construye al cargar. Solo un navegador renderiza eso. PuppeteerSharp o Playwright son la respuesta, y la API no lo es.

¿El documento se construye en C# y no tiene HTML? Facturas armadas a partir de objetos, etiquetas, entradas. Una biblioteca de diseño como QuestPDF o una de dibujo como PdfSharp encaja, y ninguna necesita red.

¿Pueden salir los datos de tu servidor? Si una norma o un contrato dice que no, usa algo que se ejecute en tu proceso o en un navegador que alojes tú. Una llamada a una API envía los datos del documento a un servicio.

¿Ya tienes HTML? Una vista Razor, una plantilla de correo, una página hecha para imprimir. Entonces la elección es entre un navegador y la API. El navegador tiene todas las funciones de la web y te cuesta su mantenimiento. La API no tiene mantenimiento y admite las partes del HTML y del CSS que importan para el papel: páginas, tablas que continúan entre páginas, encabezados y pies.

¿Dónde se ejecuta? En un contenedor o en una función serverless, un Chromium aumenta la imagen y el arranque en frío. Una llamada HTTP no aumenta ninguno de los dos.

Cómo queda la versión con la API

using var response = await http.PostAsJsonAsync(
"v1/render", new { html, title = "Factura 2026-0042" }, cancellationToken);
response.EnsureSuccessStatusCode();
byte[] pdf = await response.Content.ReadAsByteArrayAsync(cancellationToken);

No hay paquete que instalar ni archivo nativo que desplegar. El coste es la lista de lo que no hace: sin JavaScript, sin @font-face ni @import, e imágenes solo como URL data: o archivos que hayas subido. Envía antes el mismo cuerpo a POST /v1/validate: te dice lo que el servicio no pudo usar, sin PDF y sin crédito.

A dónde ir después

Lee HTML y CSS admitidos antes de decidir: lista exactamente lo que admite el renderizador.

← Todos los artículos