Converter HTML Markdown C#

Markdown é uma linguagem de marcação com símbolos simples que denotam cabeçalho, negrito, itálico, sublinhado e muito mais. É simples de aprender e escrever, portanto, a maioria da documentação on-line e arquivos leia-me são escritos usando o markdown. Você pode converter markdown em página da Web HTML facilmente com algumas etapas rápidas. Da mesma forma, a conversão de HTML para markdown também é um recurso útil que exploraremos aqui usando a linguagem C#.

Conversor de HTML e Markdown – Instalação da API

Você pode interconverter a página da Web HTML e os arquivos no formato Markdown usando a linguagem de programação C#. Você precisa instalar a API Aspose.HTML for .NET para manipular e converter esses formatos de arquivo. Você pode instalar a API da galeria NuGet com o seguinte comando de instalação ou pode baixar o arquivo DLL da seção Downloads para adicioná-lo como referência em seu projeto.

PM> Install-Package Aspose.Html

Até agora, você poderá configurar a API em alguns minutos. Vamos prosseguir para percorrer diferentes cenários possíveis:

Converter página da Web HTML em Markdown (.md) programaticamente em C#

Você pode converter páginas da Web HTML em Markdown em seus aplicativos baseados em .NET. Esse recurso de conversão popular é suportado de uma forma que você só precisa chamar a API sem entrar nos detalhes dos formatos de arquivo subjacentes. Portanto, você precisa seguir as etapas abaixo para conversão de página da Web em HTML:

  1. Crie um arquivo HTML ou carregue o arquivo de entrada existente
  2. Chame o método ConvertHTML com o objeto MarkdownSaveOptions
  3. Salvar arquivo Markdown (.md) de saída

O código abaixo mostra como converter página da Web HTML para Markdown usando C#:

// Prepare um código HTML e salve-o no arquivo.
var code = "<h1>Header 1</h1>" +
            "<h2>Header 2</h2>" +
            "<p>Hello World!!</p>";
System.IO.File.WriteAllText(dataDir + "document.html", code);

// Chame o método ConvertHTML para converter HTML em Markdown.
Aspose.Html.Converters.Converter.ConvertHTML(dataDir + "document.html", new Aspose.Html.Saving.MarkdownSaveOptions(), dataDir + "output.md");

Converter página da Web HTML em Markdown MD (.md) com opções adicionais em C#

Já aprendemos o caso de uso simples e básico de converter HTML em notação Markdown. Vamos avançar mais um passo onde estaremos controlando o processo de conversão. Considere um cenário em que há muitos dados irrelevantes em um arquivo HTML, mas só precisamos converter o conteúdo em tags de parágrafo ou hiperlink. Seguiremos as etapas abaixo para entender e experimentar esse recurso:

  1. Carregar um arquivo HTML de entrada
  2. Inicializar objeto MarkdownSaveOptions
  3. Defina as variáveis do sinalizador na propriedade Recursos
  4. Salvar arquivo Markdown de saída

O código abaixo é baseado nessas etapas que mostram como converter página da Web HTML em Markdown com opções adicionais usando C#:

// Prepare um código HTML e salve-o no arquivo.
var code = "<h1>Header 1</h1>" +
            "<h2>Header 2</h2>" +
            "<p>Hello World!!</p>" +
            "<a href='aspose.com'>aspose</a>";
System.IO.File.WriteAllText(dataDir + "document.html", code);

// Crie uma instância de SaveOptions e configure a regra: 
// - apenas <a>e</a><p> <a>elementos serão convertidos em markdown.</a>
var options = new Aspose.Html.Saving.MarkdownSaveOptions();
options.Features = Aspose.Html.Saving.MarkdownFeatures.Link | Aspose.Html.Saving.MarkdownFeatures.AutomaticParagraph;

// Chame o método ConvertHTML para converter o HTML em Markdown.
Aspose.Html.Converters.Converter.ConvertHTML(dataDir + "document.html", options, dataDir + "output_options.md");

Converter Markdown (.md) em página da Web HTML programaticamente usando C#

Pode ser necessário converter HTML em notação Markdown em alguns cenários. Por exemplo, algumas seções de documentação são utilizadas em aplicativos da Web e em muitos outros casos de uso. Você pode converter facilmente o arquivo Markdown em HTML com as seguintes etapas:

  1. Crie um arquivo Markdown (.md) ou carregue o arquivo de entrada
  2. Salve o arquivo HTML de saída com o método ConvertMarkdown

O código abaixo mostra como converter um arquivo Markdown (.md) em uma página da Web HTML usando a linguagem de programação C#:

// Prepare um exemplo simples de Markdown
var code = "### Hello World" +
            "\r\n" +
            "[visit applications](https://products.aspose.app/html/family)";
// Criar um arquivo Markdown
System.IO.File.WriteAllText(dataDir + "input_document.md", code);

// Converter Markdown em documento HTML
Aspose.Html.Converters.Converter.ConvertMarkdown(dataDir + "input_document.md", dataDir + "MarkdownToHTMLoutput.html");

Baixe Projeto de Exemplo e Arquivos de Amostra

Compilamos um projeto de amostra como uma demonstração dos recursos mencionados, onde você também pode baixar os arquivos de amostra. É um aplicativo de console que você pode experimentar para explorar e entender os recursos de remarcação e interconversão de HTML. Então você pode baixar o ZIP ou clonar o GitHub Repository para testar os recursos.

Conclusão

Em poucas palavras, exploramos a conversão de páginas da Web HTML e arquivos Markdown em detalhes. A API pode converter esses arquivos de forma rápida e eficiente com chamadas de API simples. Além disso, você pode conhecer outros recursos visitando Documentação do produto e Referências da API. No entanto, em caso de dúvidas, sinta-se à vontade para entrar em contato conosco através do Fórum de Suporte Gratuito.

Veja também