
Convertidor de HTML a PDF en línea con C# .NET.
Convertir HTML contenido a PDF es esencial para compartir, imprimir, archivar o preservar el formato. Con el GroupDocs.Conversion Cloud SDK para .NET, puedes realizar conversiones de HTML a PDF de alta fidelidad sin depender de complementos del navegador o herramientas externas.
En este artículo, aprenderás cómo:
API de conversión de HTML a PDF
El GroupDocs.Conversion Cloud SDK for .NET es una API REST de alta calidad y escalable que ofrece las capacidades para realizar la conversión de HTML a PDF en línea. Asegura que el formato del contenido, incluyendo el diseño, la disposición y los medios incrustados, se mantenga en el PDF resultante.
Requisitos previos
- Un entorno de desarrollo .NET (por ejemplo, Visual Studio)
- GroupDocs.Conversion Cloud SDK para .NET instalado a través de NuGet
- ID de cliente y secreto de cliente from GroupDocs Cloud
Instala el SDK usando NuGet:
Instalar usando npm:
PM> NuGet\Install-Package GroupDocs.Conversion-Cloud
Paso a paso: Convertir HTML a PDF en C#
Por favor, sigue los pasos indicados a continuación para realizar la conversión gratuita de HTML a PDF en línea usando C# .NET:
📌 Paso 1: Inicializar la Configuración de la API:
var config = new Configuration
{
ClientId = "YOUR_CLIENT_ID",
ClientSecret = "YOUR_CLIENT_SECRET"
};
var convertApi = new ConvertApi(config);
var fileApi = new FileApi(config);
📌 Paso 2: Cargar el archivo HTML en el almacenamiento en la nube:
using (var fileStream = File.OpenRead("input.html"))
{
var uploadRequest = new UploadFileRequest("input.html", fileStream);
fileApi.UploadFile(uploadRequest);
}
📌 Paso 3: Definir la configuración de conversión y convertir:
var settings = new ConvertSettings
{
FilePath = "input.html",
Format = "pdf",
OutputPath = "converted/output.pdf"
};
var request = new ConvertDocumentRequest(settings);
convertApi.ConvertDocument(request);
Console.WriteLine("✅ HTML file successfully converted to PDF.");
// More examples over https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet
// Obtén tus credenciales de API
string clientId = "4bdefca3-f08c-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "a43c8b4365246a062688a259abe5b469";
// Cree una instancia de la clase Configuration e inicialícela con el Client ID y el Client Secret.
var configurations = new GroupDocs.Conversion.Cloud.Sdk.Client.Configuration(clientId, clientSecret1);
// Define el valor de ApiBaseUrl para establecer la URL base de la API del convertidor de HTML a PDF.
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
// Inicializa una instancia de la clase ConvertApi con el objeto de la clase Configuration.
var apiInstance = new GroupDocs.Conversion.Cloud.Sdk.Api.ConvertApi(configurations);
// cargar el archivo HTML desde el disco local
using (var stream = System.IO.File.OpenRead("converted.html"))
{
// crear una instancia de FileApi
var fileUpload = new FileApi(configurations);
// upload the input HTML file to cloud storage
fileUpload.UploadFile(new UploadFileRequest("input.html", stream));
// crear ConvertSettings donde definimos el HTML de entrada y el nombre del PDF resultante
var settings = new ConvertSettings
{
StorageName = "internal",
FilePath = "input.html",
Format = "pdf",
OutputPath = "resultant.pdf"
};
// Invocar el método ConvertDocument para convertir HTML a PDF de forma programática.
var response = apiInstance.ConvertDocument(new GroupDocs.Conversion.Cloud.Sdk.Model.Requests.ConvertDocumentRequest(settings));
if (response != null && response.Equals("OK"))
{
// print succeess message
Console.WriteLine("HTMl to PDF conversion completed successfully !");
}
}
Image:- Una vista previa de la conversión de HTML a PDF.
Descargue el archivo PDF de muestra generado en el ejemplo anterior de resultant.pdf.
Opcional: Convertir HTML a PDF con cURL
Si prefieres utilizar herramientas de línea de comandos o tuberías de automatización, el GroupDocs.Conversion Cloud también puede ser accedido a través de cURL.
- Este método es ideal para pipelines de automatización y conversiones basadas en scripts.
Paso 1: Obtén el Token de Acceso JWT
curl -v "https://api.groupdocs.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET" \
-H "Content-Type: application/x-www-form-urlencoded"
Paso 2: Convertir HTML a PDF
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"default\", \"FilePath\": \"{sourcePDF}\", \"Format\": \"html\", \"OutputPath\": \"{finalOutput}\"}"
Replace:
- sourceFile, resultantFile, and accessToken with actual values.
- Ahora, para guardar el PDF en el disco local, puede considerar usar el siguiente comando cURL:
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"default\", \"FilePath\": \"{sourceFile}\", \"Format\": \"html\"}" \
-o "myOutput.html"
Prueba el Convertidor de HTML a PDF en Línea Gratis
¿Quieres una solución rápida y sin código? Usa el HTML to PDF Converter para transformar el contenido web al instante.

Conclusión
Con la ayuda de GroupDocs.Conversion Cloud SDK para .NET, puedes convertir sin problemas HTML a PDF dentro de tus aplicaciones C#. Ya sea para exportación de documentos, generación de informes o archivo de contenido web estilizado, esta API ofrece flexibilidad y control total.
Recursos Útiles
Artículos Relacionados
Recomendamos explorar los siguientes artículos: