No cenário digital de hoje, HTML é um dos formatos mais amplamente utilizados para exibir e compartilhar dados estruturados online. No entanto, quando se trata de arquivamento, distribuição ou acesso offline, PDF continua a ser o formato preferido. Os desenvolvedores frequentemente precisam converter HTML em PDF para criar relatórios, faturas ou preservar conteúdo da web em um formato universalmente compatível.

Este artigo cobre os seguintes tópicos:

SDKs de Conversão de HTML para PDF

O GroupDocs.Conversion Cloud SDK para .NET fornece uma solução poderosa e escalável para a transformação de formatos de arquivo. Ao usar as capacidades desta API, você pode converter HTML para PDF de forma transparente, garantindo precisão, consistência e desempenho superior—tudo isso sem instalar software adicional.

Começando com a Conversão de HTML para PDF

Antes de começar, certifique-se de ter os seguintes pré-requisitos:

  1. Uma conta do GroupDocs Cloud para obter seu ID do Cliente e Segredo do Cliente. Para mais informações, visite o tutorial curto.
  2. Um arquivo HTML de amostra ou página da web para testes.
  3. Um ambiente de desenvolvimento .NET configurado (como Visual Studio ou Rider).

Você pode instalar o SDK a partir do NuGet Package Manager executando o seguinte comando:

Install-Package GroupDocs.Conversion-Cloud -Version 25.9.0

Converter HTML para PDF com C#

Vamos explorar como realizar a conversão de HTML para PDF programaticamente usando C# e o GroupDocs Cloud SDK.

  1. Crie uma instância da classe Configuration onde passamos as credenciais do cliente como argumentos.
var configuration = new Configuration
{
    AppSid = "YOUR_CLIENT_ID",
    AppKey = "YOUR_CLIENT_SECRET"
};
  1. Inicialize uma instância de ConvertApi e FileApi onde passamos o objeto Configuration como argumentos.
var convertApi = new ConvertApi(configuration);
var fileApi = new FileApi(configuration);
  1. Upload the input HTML to cloud storage.
using (var stream = File.OpenRead("source.html"))
{
    var uploadRequest = new UploadFileRequest("source.html", stream);
    fileApi.UploadFile(uploadRequest);
}
  1. Crie uma instância de ConvertSettings onde especificamos o nome para o HTML de entrada, o formato de saída como pdf e o nome do PDF resultante.
var settings = new ConvertSettings
{
    FilePath = "index.html",
    Format = "pdf",
    OutputPath = "converted/html-to-pdf-result.pdf"
};
  1. Chame a ConvertDocumentRequest API para converter HTML para o formato PDF. Após a conversão bem-sucedida, o PDF resultante é armazenado em armazenamento em nuvem.
var request = new ConvertDocumentRequest(settings);
convertApi.ConvertDocument(request);

Uma vez que a solicitação seja executada, seu arquivo HTML será convertido em um PDF de alta qualidade e armazenado na pasta de saída especificada dentro do seu armazenamento em nuvem.

Conversão de HTML para PDF usando cURL

Se você prefere realizar conversões por meio de scripts ou pipelines de automação, o cURL é uma excelente alternativa. Ele permite que você execute chamadas de API REST diretamente da linha de comando, tornando-o ideal para testes rápidos e processamento em lote.

Why Use cURL for HTML to PDF Conversion?

  • Nenhuma instalação do SDK é necessária.
  • Perfeito para scripts de shell, fluxos de trabalho de CI/CD ou serviços de backend.
  • Leve e fácil de automatizar.

Antes de executar o comando de conversão de HTML para PDF, gere seu token de acesso JWT, com base nas credenciais do cliente. Uma vez que o token tenha sido gerado, execute o seguinte comando.

curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-d "{  \"StorageName\": \"internal\",  \"FilePath\": \"{sourceFile}\",  \"Format\": \"pdf\",  \"LoadOptions\": {    \"Format\": \"html\"  },  \"ConvertOptions\": {    \"FromPage\": 1,    \"PagesCount\": 1,    \"Pages\": [      1    ],    \"WatermarkOptions\": {      \"Text\": \"Confidential\",      \"FontName\": \"Arial\",      \"FontSize\": 12,      \"Bold\": false,      \"Italic\": true,      \"Color\": \"Red\",      \"Width\": 10,      \"Height\": 6,      \"Top\": 100,      \"Left\": 100,      \"RotationAngle\": 10,      \"Transparency\": 0.8,      \"Background\": true,      \"AutoAlign\": true    }  },  \"OutputPath\": \"{converted}\"}"

Substitua {ACCESSTOKEN} pelo seu token JWT gerado e index.html pelo nome do seu arquivo HTML.

Experimente o conversor de HTML para PDF gratuito

Se você deseja explorar o processo de conversão sem escrever nenhum código, experimente o free HTML to PDF Converter aplicativo web alimentado por GroupDocs.Conversion Cloud. Ele permite que você envie qualquer arquivo HTML ou URL e baixe instantaneamente o PDF gerado.

html to pdf converter

Conclusão

Converter HTML para PDF usando a API REST .NET fornece aos desenvolvedores uma maneira confiável de preservar o layout, estilos e conteúdo das páginas da web em um formato portátil. Com o GroupDocs.Conversion Cloud SDK para .NET, você pode automatizar esse processo em apenas algumas linhas de código—seja você precisar converter arquivos HTML individuais ou lotes inteiros de páginas da web.

Artigos Relacionados

Recomendamos fortemente visitar os seguintes links para saber mais sobre:

Perguntas Frequentes (FAQs)

  1. How can I convert HTML to PDF using C# .NET?
  • Você pode usar o GroupDocs.Conversion Cloud SDK para .NET para fazer o upload de um arquivo HTML, configurar o formato de saída como PDF e executar o ConvertDocument() método para gerar o arquivo convertido.
  1. Este API suporta a conversão de HTML com CSS e imagens?
  • Sim. O SDK mantém todos os recursos vinculados, garantindo que seu PDF convertido preserve layout, fontes, imagens e estilos de forma precisa.
  1. Posso converter páginas da web diretamente de URLs?
  • Sim. Você pode especificar uma URL de página da web no caminho de entrada, e a API renderizará o conteúdo HTML e o converterá em um documento PDF.
  1. Eu preciso instalar alguma ferramenta de terceiros, como o Adobe Acrobat?
  • Não. Todo o processo é baseado na nuvem—nenhuma instalação local ou software adicional é necessário.