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
- Un cliente tipado, reintentos y los errores a tratar: Cómo generar un PDF desde HTML en C# y ASP.NET Core.
- Páginas que ya existen en la web: Convertir una página web a PDF en C# sin navegador headless.
- Una tabla que ocupa varias páginas, con totales y números de página: Generador de informes PDF en C#.
Lee HTML y CSS admitidos antes de decidir: lista exactamente lo que admite el renderizador.
Sigue leyendo
Código e integraciones
Generar un PDF en ASP.NET Core: MVC, Razor Pages y minimal APIs
Convierte una vista Razor en PDF en ASP.NET Core con una llamada a la API: renderizador de vistas, vista lista para imprimir, acción MVC y handler de Razor Pages.
3 min de lectura
Código e integraciones
Convertir una página web a PDF en C# sin navegador headless
Descarga una página con HttpClient y convierte su HTML en PDF con una llamada a la API en C#. Qué páginas admite, cuáles no y cómo comprobarlo de antemano.
3 min de lectura
Código e integraciones
Generador de informes PDF en C#: tabla paginada con totales
Crea un informe PDF en C# a partir de una lista de objetos: tabla con la cabecera repetida en cada página, total, números de página y recuento de páginas.
3 min de lectura
Código e integraciones
Guardar un PDF en C#: en disco, como descarga o en blob storage
Guarda el PDF que devuelve una llamada de renderizado en C#: escríbelo en disco, envíalo como descarga en ASP.NET Core, usa un enlace firmado o súbelo al storage.
2 min de lectura