C# Markdown 병합 작동 방식

Aspose.HTML for .NET 은 2단계 C# 워크플로로 Markdown을 병합합니다. Converter.ConvertMarkdown()은 각 .md 소스를 HTMLDocument로 구문 분석하고, HtmlRenderer는 변환된 문서를 지정된 순서로 하나의 출력 장치에 씁니다. 결과는 PDF, XPS, DOCX 또는 TIFF 문서이며, 연결된 편집 가능한 Markdown 파일이 아닙니다.


C# Markdown 병합 및 대화형 예제

대화형 예제를 사용하여 소스 순서를 구성하고 이에 맞는 C# 워크플로를 생성합니다. Markdown 파일을 필요한 순서로 추가한 다음 PDF, XPS, DOCX 또는 TIFF를 선택합니다. 현재 선택이 변경될 때마다 코드 패널에서 파일 이름, 렌더링 장치 및 출력 확장자가 업데이트됩니다. 구성한 병합을 온라인으로 실행하여 결과를 확인할 수도 있습니다.

Markdown 파일 병합 워크플로

예제는 기본적으로 PDF를 사용합니다. 동일한 2단계 워크플로를 위젯에서 제공하는 다른 장치 기반 출력에도 적용할 수 있습니다.

  1. 각 소스 파일에 대해 Converter.ConvertMarkdown() 을 호출하여 HTMLDocument를 만듭니다.
  2. 렌더링된 페이지가 나타나야 하는 순서로 변환된 문서를 유지합니다.
  3. HtmlRenderer 인스턴스를 만듭니다.
  4. PDF용 PdfDevice 와 같은 출력 장치를 만듭니다.
  5. 장치와 변환된 모든 문서를 HtmlRenderer.Render()에 전달합니다.

Markdown 병합 출력 형식 선택

  • PDF – 배포 또는 인쇄용 고정 레이아웃 문서를 만듭니다.
  • XPS – 렌더링된 페이지를 XPS 문서에 씁니다.
  • DOCX – Microsoft Word 또는 다른 호환 편집기에서 열 수 있는 문서를 만듭니다.
  • TIFF – 결합된 페이지를 래스터 이미지 출력으로 렌더링합니다.

생성된 C# 코드는 선택한 형식에 따라 PdfDevice, XpsDevice, DocDevice 또는 ImageDevice를 선택합니다. 형식별 설정은 C# 렌더링 장치 를 참조하십시오.


Markdown 파일 병합 시 알아둘 사항

  • 결과는 렌더링된 출력입니다. 제목, 목록, 코드 블록, 링크 및 기타 구문 분석된 Markdown 콘텐츠는 중간 HTML 문서의 일부가 되며 원본 .md 소스는 연결되지 않습니다.
  • 입력 순서가 출력 순서를 결정합니다. 위젯에서 파일을 정렬하거나 변환된 HTMLDocument 객체를 필요한 순서로 Render()에 전달합니다.
  • 참조된 리소스를 계속 사용할 수 있어야 합니다. 중간 HTML을 렌더링할 때 상대 이미지와 기타 연결된 리소스의 위치를 확인할 수 있어야 합니다.
  • 출력 설정은 장치별로 적용됩니다. 페이지 크기, 여백, 해상도 및 기타 옵션은 Markdown 파서가 아니라 선택한 출력 장치와 렌더링 옵션에 설정합니다.

Aspose.HTML for .NET 설치

.NET CLI를 사용하여 NuGet에서 Aspose.HTML for .NET 을 설치합니다.

dotnet add package Aspose.HTML

NuGet 패키지 관리자 UI를 사용하거나 패키지 관리자 콘솔에서 Install-Package Aspose.HTML을 실행할 수도 있습니다. 설정 방법은 설치 가이드 를 참조하세요. 평가 제한 없이 API를 테스트하려면 임시 라이선스 를 요청할 수 있습니다.


Markdown 파일 병합 FAQ

1. 스트림으로 제공된 Markdown을 병합할 수 있습니까?

예. 각 소스에 Converter.ConvertMarkdown(Stream, string) 오버로드를 사용하고 상대 링크와 이미지를 해석할 기본 URI를 제공합니다. 이 메서드는 다른 변환된 소스와 함께 렌더러 호출에 포함할 수 있는 HTMLDocument를 반환합니다.

2. 결과를 렌더링하기 전에 변환된 Markdown을 편집할 수 있습니까?

예. Converter.ConvertMarkdown()은 HTMLDocument를 반환하므로 애플리케이션에서 HtmlRenderer.Render()에 전달하기 전에 DOM을 검사하거나 수정할 수 있습니다. 결합된 출력에 생성된 제목, 구분 기호 또는 정규화된 콘텐츠가 필요한 경우 유용합니다.

3. 변환된 Markdown과 기존 HTML 문서를 하나의 출력에 포함할 수 있습니까?

예. Markdown 소스가 HTMLDocument 객체로 변환된 후 기존 HTMLDocument와 함께 동일한 HtmlRenderer.Render() 호출에 포함합니다. 인수 순서가 렌더링된 출력에서의 문서 순서를 결정합니다.

4. Markdown 파일의 상대 이미지가 결과에 표시됩니까?

경로를 해석할 수 있고 렌더링 중 리소스에 접근할 수 있으면 표시됩니다. 소스 위치와 관련 리소스를 함께 유지하거나 올바른 이미지 파일을 가리키는 문서 기본 위치를 제공하십시오.

5. 병합된 PDF의 페이지 크기와 여백을 설정할 수 있습니까?

예. PdfRenderingOptions를 만들고 PageSetup을 구성한 다음 옵션을 PdfDevice에 전달합니다. 선택한 페이지 설정은 변환된 모든 Markdown 문서를 동일한 PDF로 렌더링할 때 적용됩니다.

관련 파일 병합 도구

다른 소스 형식을 선택하거나 파일 병합 개요로 돌아갑니다.