오늘날의 디지털 환경에서, HTML은 온라인에서 구조화된 데이터를 표시하고 공유하는 가장 널리 사용되는 형식 중 하나입니다. 그러나 아카이빙, 배포 또는 오프라인 접근에 있어서는 PDF가 선택되는 형식입니다. 개발자들은 종종 보고서, 청구서 작성 또는 웹 콘텐츠를 보편적으로 호환 가능한 형식으로 보존하기 위해 HTML을 PDF로 변환해야 합니다.

이 기사에서는 다음 주제를 다루고 있습니다:

HTML to PDF 변환 SDK들

The GroupDocs.Conversion Cloud SDK for .NET는 파일 형식 변환을 위한 강력하고 확장 가능한 솔루션을 제공합니다. 이 API의 기능을 사용하면 HTML을 PDF로 원활하게 변환할 수 있으며, 정확성, 일관성 및 우수한 성능을 보장합니다. 모든 과정이 추가 소프트웨어를 설치하지 않고 이루어집니다.

HTML을 PDF 변환 시작하기

시작하기 전에 다음 필수 조건이 충족되었는지 확인하세요:

  1. A GroupDocs Cloud account to obtain your Client ID and Client Secret. For more information, please visit short tutorial.
  2. A sample HTML file or webpage for testing.
  3. 구성된 .NET 개발 환경(예: Visual Studio 또는 Rider).

다음 명령을 실행하여 NuGet 패키지 관리자에서 SDK를 설치할 수 있습니다:

Install-Package GroupDocs.Conversion-Cloud -Version 25.9.0

HTML을 PDF로 변환하기 C#

HTML에서 PDF로 변환하는 방법을 C# 및 GroupDocs Cloud SDK를 사용하여 프로그래밍 방식으로 탐색해 보겠습니다.

  1. Configuration 클래스의 인스턴스를 생성하여 클라이언트 자격 증명을 인수로 전달합니다.
var configuration = new Configuration
{
    AppSid = "YOUR_CLIENT_ID",
    AppKey = "YOUR_CLIENT_SECRET"
};
  1. ConvertApi와 FileApi의 인스턴스를 초기화하고, Configuration 객체를 인수로 전달합니다.
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. ConvertSettings의 인스턴스를 생성하여 입력 HTML의 이름, 출력 형식을 pdf로 설정하고 결과 PDF의 이름을 지정합니다.
var settings = new ConvertSettings
{
    FilePath = "index.html",
    Format = "pdf",
    OutputPath = "converted/html-to-pdf-result.pdf"
};
  1. HTML을 PDF 형식으로 변환하기 위해 ConvertDocumentRequest API를 호출하십시오. 변환이 성공적으로 완료되면 결과 PDF는 클라우드 스토리지에 저장됩니다.
var request = new ConvertDocumentRequest(settings);
convertApi.ConvertDocument(request);

요청이 실행되면, 귀하의 HTML 파일이 고품질 PDF로 변환되어 클라우드 저장소 내 지정된 출력 폴더에 저장됩니다.

HTML to PDF Conversion using cURL

스크립팅이나 자동화 파이프라인을 통해 변환을 수행하는 것을 선호한다면, cURL은 훌륭한 대안입니다. 이는 명령줄에서 REST API 호출을 직접 실행할 수 있게 해주어, 빠른 테스트와 배치 처리에 이상적입니다.

왜 cURL을 사용하여 HTML을 PDF로 변환하나요?

  • SDK 설치가 필요 없습니다.
  • 셸 스크립트, CI/CD 워크플로우 또는 백엔드 서비스에 완벽합니다.
  • 가볍고 자동화하기 쉽습니다.

HTML에서 PDF로 변환 명령을 실행하기 전에 클라이언트 자격 증명을 기반으로 JWT 액세스 토큰을 생성하십시오. 토큰이 생성되면, 다음 명령을 실행하십시오.

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}\"}"

{ACCESSTOKEN}를 생성한 JWT 토큰으로 교체하고 index.html을 HTML 파일의 이름으로 교체하세요.

무료 HTML에서 PDF 변환기 사용해 보세요.

코드를 작성하지 않고 변환 프로세스를 탐색하고 싶다면 무료 HTML to PDF Converter를 시도해 보세요. 웹 앱은 GroupDocs.Conversion Cloud에 의해 지원됩니다. 이는 HTML 파일이나 URL을 업로드하고 생성된 PDF를 즉시 다운로드할 수 있게 해줍니다.

html to pdf converter

유용한 링크

결론

HTML을 PDF로 변환하기 위한 .NET REST API는 개발자에게 웹페이지 레이아웃, 스타일 및 콘텐츠를 휴대 가능한 형식으로 유지하는 신뢰할 수 있는 방법을 제공합니다. GroupDocs.Conversion for .NET Cloud SDK를 사용하면 이 과정 자동화를 몇 줄의 코드로 수행할 수 있습니다. 단일 HTML 파일을 변환해야 하든 전체 웹 페이지 배치를 변환해야 하든 상관없이 가능합니다.

관련 기사

다음 링크를 방문하여 더 많은 정보를 알아보시기 바랍니다:

자주 묻는 질문 (FAQs)

  1. C# .NET에서 HTML을 PDF로 변환하려면 여러 가지 방법을 사용할 수 있습니다. 그 중 하나는 iTextSharp 라이브러리를 사용하는 것입니다. 다음은 iTextSharp를 사용하여 HTML을 PDF로 변환하는 방법의 예입니다.

  2. 먼저, NuGet 패키지 관리자를 사용하여 iTextSharp를 설치합니다.

    Install-Package itext7

  3. 다음은 HTML을 PDF로 변환하는 코드 예제입니다.

    using System;
using System.IO;
using iText.Html2pdf;

class Program
{
    static void Main(string[] args)
    {
        string html = "<h1>Hello, World!</h1><p>This is a PDF conversion example.</p>";
        string pdfPath = "output.pdf";

        HtmlConverter.ConvertToPdf(html, new FileStream(pdfPath, FileMode.Create));
        Console.WriteLine("PDF created successfully at " + pdfPath);
    }
}

이 코드는 주어진 HTML 문자열을 사용하여 PDF 파일을 생성합니다. output.pdf라는 이름으로 현재 디렉토리에 저장됩니다. 필요한 경우 HTML 내용을 동적으로 생성하거나 파일에서 읽어올 수 있습니다.

  • You can use GroupDocs.Conversion Cloud SDK for .NET to upload an HTML file, configure the output format as PDF, and execute the ConvertDocument() method to generate the converted file.
  1. 이 API는 CSS와 이미지를 포함한 HTML 변환을 지원합니까?
  • 네. SDK는 연결된 모든 리소스를 유지하여 변환된 PDF가 레이아웃, 글꼴, 이미지 및 스타일을 정확하게 보존하도록 보장합니다.
  1. URL로부터 웹 페이지를 직접 변환할 수 있나요?
  • 네. 입력 경로에 웹페이지 URL을 지정하면 API가 HTML 콘텐츠를 렌더링하고 PDF 문서로 변환합니다.
  1. Adobe Acrobat과 같은 서드파티 도구를 설치해야 하나요?
  • 아니요. 전체 프로세스는 클라우드 기반이며, 로컬 설치나 추가 소프트웨어가 필요하지 않습니다.