Editar documentos HTML e Markdown em C#

APIs de edição de documentos para aplicações C#

O Aspose.HTML for .NET fornece APIs estruturadas para editar conteúdo HTML e Markdown. Use um HTMLDocument para alterar o DOM HTML ou analise o Markdown em uma árvore de sintaxe tipada antes de atualizar seus nós. Após a edição, salve o documento em seu formato editável ou encaminhe-o para um fluxo separado de arquivamento ou conversão.

Escolher um fluxo de edição de HTML ou Markdown

• Edição de HTML . Carregue um arquivo, URL, string ou stream HTML, localize elementos do DOM, altere texto, atributos, estilos ou a estrutura do documento e salve o HTML modificado.
• Edição de Markdown . Analise um arquivo MD existente em uma AST tipada, atualize títulos, parágrafos, listas, links ou outros nós de sintaxe e serialize a árvore modificada novamente como Markdown.
• Fluxo de HTML para MHTML . Edite primeiro o HTML e depois empacote o documento alterado e os recursos processados em um arquivo MHTML. Arquivos MHTML e MHT existentes são entradas de renderização ou conversão, não fontes editáveis do DOM HTML.

Atualizar metadados de uma página HTML em C#

Este exemplo carrega um documento HTML, atualiza o título e a meta description da página, cria os elementos de metadados ausentes quando necessário e salva o arquivo editado. O fluxo de Markdown usa uma API separada de árvore de sintaxe tipada.

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");

Etapas principais da edição de HTML

1. Carregue a origem com um construtor de HTMLDocument .
2. Localize o elemento necessário com QuerySelector() , GetElementById(), XPath ou outro método de navegação pelo DOM.
3. Atualize texto, atributos, estilos ou nós filhos por meio da API DOM.
4. Chame Save() para gravar o HTML ou prossiga para um fluxo específico de conversão ou criação de arquivo MHTML.

O que pode ser editado por programação

• Estrutura do documento. Adicione, substitua, mova ou remova nós do DOM HTML e nós de sintaxe Markdown compatíveis.
• Texto e marcação. Atualize texto simples, marcação HTML, títulos, parágrafos, listas, links, blocos de código e outros conteúdos estruturados.
• Atributos HTML e CSS. Altere atributos de elementos, estilos inline, conteúdo de <style> e referências a folhas de estilo.
• Nós selecionados. Encontre elementos HTML com seletores CSS ou consultas XPath e percorra o Markdown por meio de nós AST tipados.
• Fluxo de saída. Salve HTML ou Markdown editável, crie MHTML a partir de HTML editado ou envie o conteúdo preparado para uma API de conversão quando o resultado final precisar ser PDF, DOCX, XPS ou uma imagem.

Documentação sobre edição de documentos

O guia Editar documento HTML aborda alterações em nós do DOM, atributos, texto e marcação. Consulte Editar e modificar Markdown para ver exemplos com a AST tipada de Markdown. A seção Trabalhar com documentos HTML explica carregamento, edição, configuração do ambiente, salvamento e processamento de recursos.

Instalar o Aspose.HTML for .NET

Instale o Aspose.HTML for .NET pelo NuGet usando a CLI do .NET:

dotnet add package Aspose.HTML

Você também pode usar a interface do Gerenciador de Pacotes NuGet ou executar Install-Package Aspose.HTML no Console do Gerenciador de Pacotes. Consulte o guia de instalação para configurar a biblioteca ou solicite uma licença temporária para avaliar a API sem limitações.

Perguntas frequentes sobre edição de HTML, Markdown e MHTML

1. Como editar um arquivo HTML em C#?

Carregue o arquivo em um HTMLDocument, localize os elementos necessários do DOM com QuerySelector(), GetElementById(), XPath ou navegação pelo DOM, atualize texto, atributos, estilos ou nós filhos e chame Save() para gravar o HTML editado.

2. Devo editar Markdown diretamente ou convertê-lo primeiro em HTML?

Edite diretamente a MarkdownSyntaxTree quando o resultado precisar continuar sendo um arquivo MD. Converta primeiro o Markdown em HTML quando o fluxo exigir operações no DOM HTML, marcação voltada ao navegador ou uma saída renderizada em vez do código-fonte Markdown atualizado.

3. Posso editar um arquivo MHTML existente em C#?

Um arquivo MHTML ou MHT existente não é carregado como um HTMLDocument editável. Edite o HTML original e crie um novo arquivo MHTML com o documento atualizado. Use o fluxo de conversão quando apenas a origem MHTML arquivada estiver disponível.