C#에서 HTML 및 Markdown 문서 편집

C# 애플리케이션을 위한 문서 편집 API

Aspose.HTML for .NET 은 HTML 및 Markdown 콘텐츠를 편집할 수 있는 구조화된 API를 제공합니다. HTMLDocument 를 사용해 HTML DOM을 변경하거나, Markdown을 타입 지정 구문 트리로 파싱한 다음 노드를 업데이트할 수 있습니다. 편집 후에는 문서를 편집 가능한 형식으로 저장하거나 별도의 아카이브 또는 변환 워크플로로 전달할 수 있습니다.

HTML 또는 Markdown 편집 워크플로 선택

• HTML 편집 . HTML 파일, URL, 문자열 또는 스트림을 로드하고 DOM 요소를 찾은 다음 텍스트, 속성, 스타일 또는 문서 구조를 변경하여 수정된 HTML을 저장합니다.
• Markdown 편집 . 기존 MD 파일을 타입 지정 AST로 파싱하고 제목, 단락, 목록, 링크 또는 다른 구문 노드를 업데이트한 다음 변경된 트리를 다시 Markdown으로 직렬화합니다.
• HTML에서 MHTML로 저장 . 먼저 HTML을 편집한 다음 변경된 문서와 처리된 리소스를 MHTML 아카이브로 패키징합니다. 기존 MHTML 및 MHT 아카이브는 편집 가능한 HTML DOM 소스가 아니라 렌더링 또는 변환 입력으로 사용됩니다.

C#에서 HTML 페이지 메타데이터 업데이트

다음 예제는 HTML 문서를 로드하고 페이지 제목과 메타 설명을 업데이트하며, 필요한 메타데이터 요소가 없으면 생성한 뒤 편집된 파일을 저장합니다. Markdown 워크플로는 별도의 타입 지정 구문 트리 API를 사용합니다.

using Aspose.Html;
using Aspose.Html.Dom;

using HTMLDocument document = new HTMLDocument("input.html");

// Update the document title through the HTMLDocument API
document.Title = "Updated page title";

// Find the head and create the description element when it is missing
Element head = document.QuerySelector("head");
if (head != null)
{
    Element description = document.QuerySelector("meta[name='description']");
    if (description == null)
    {
        description = document.CreateElement("meta");
        description.SetAttribute("name", "description");
        head.AppendChild(description);
    }

    description.SetAttribute("content", "Updated page description.");
}

document.Save("edited.html");

HTML 편집의 핵심 단계

1. HTMLDocument 생성자로 소스를 로드합니다.
2. QuerySelector() , GetElementById(), XPath 또는 다른 DOM 탐색 메서드로 필요한 요소를 찾습니다.
3. DOM API를 통해 텍스트, 속성, 스타일 또는 자식 노드를 업데이트합니다.
4. Save() 를 호출해 HTML을 저장하거나 전용 변환 또는 MHTML 아카이브 워크플로로 계속 진행합니다.

프로그래밍 방식으로 편집할 수 있는 항목

• 문서 구조. HTML DOM 노드와 지원되는 Markdown 구문 노드를 추가, 교체, 이동 또는 제거합니다.
• 텍스트와 마크업. 일반 텍스트, HTML 마크업, 제목, 단락, 목록, 링크, 코드 블록 및 기타 구조화된 콘텐츠를 업데이트합니다.
• HTML 속성과 CSS. 요소 속성, 인라인 스타일, <style> 콘텐츠 및 스타일시트 참조를 변경합니다.
• 선택한 노드. CSS 선택자 또는 XPath 쿼리 로 HTML 요소를 찾고, 타입 지정 AST 노드를 통해 Markdown을 탐색합니다.
• 출력 워크플로. 편집 가능한 HTML 또는 Markdown을 저장하거나, 편집된 HTML에서 MHTML을 만들거나, 최종 결과가 PDF, DOCX, XPS 또는 이미지여야 할 때 준비된 콘텐츠를 변환 API로 전달합니다.

문서 편집 가이드

HTML 문서 편집 가이드에서는 DOM 노드, 속성, 텍스트 및 마크업 변경을 설명합니다. 타입 지정 Markdown AST 예제는 Markdown 편집 및 수정 을 참조하세요. HTML 문서 작업 섹션에서는 로드, 편집, 환경 구성, 저장 및 리소스 처리를 설명합니다.

Aspose.HTML for .NET 설치

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

dotnet add package Aspose.HTML

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

HTML, Markdown 및 MHTML 편집 FAQ

1. C#에서 HTML 파일을 편집하려면 어떻게 해야 하나요?

파일을 HTMLDocument로 로드하고 QuerySelector(), GetElementById(), XPath 또는 DOM 탐색으로 필요한 요소를 찾습니다. 그런 다음 텍스트, 속성, 스타일 또는 자식 노드를 업데이트하고 Save()를 호출해 편집된 HTML을 저장합니다.

2. Markdown을 직접 편집해야 하나요, 아니면 먼저 HTML로 변환해야 하나요?

결과를 MD 파일로 유지해야 한다면 MarkdownSyntaxTree를 직접 편집합니다. HTML DOM 작업, 브라우저용 마크업 또는 업데이트된 Markdown 소스가 아닌 렌더링 결과가 필요하다면 먼저 Markdown을 HTML로 변환합니다.

3. C#에서 기존 MHTML 파일을 편집할 수 있나요?

기존 MHTML 또는 MHT 아카이브는 편집 가능한 HTMLDocument로 로드되지 않습니다. 원본 HTML을 편집하고 업데이트된 문서에서 새 MHTML 아카이브를 만드세요. 아카이브된 MHTML 소스만 있다면 변환 워크플로를 사용합니다.