Converter HTML Markdown C#

Markdown é uma linguagem de marcação com símbolos simples que denotam título, negrito, itálico, sublinhado e muito mais. É simples de aprender e escrever, então principalmente a documentação online e os 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 converter a página da Web HTML e os arquivos de 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 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 a página da Web HTML para 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 a conversão de páginas 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 uma página da Web HTML em 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) com opções adicionais em C#

Já aprendemos o caso de uso simples e básico de converter HTML para 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 testar esse recurso:

  1. Carregar um arquivo HTML de entrada
  2. Inicialize o objeto MarkdownSaveOptions
  3. Defina as variáveis Flag na propriedade Features
  4. Salvar arquivo Markdown de saída

O código abaixo é baseado nestas etapas que mostram como converter uma 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) para página da Web HTML programaticamente usando C#

Pode ser necessário converter HTML para notação Markdown em alguns cenários. Por exemplo, alguma seção de documentação a ser utilizada em aplicações web e muitos outros casos de uso. Você pode converter facilmente o arquivo Markdown para 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) para 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");

Baixar Projeto de Exemplo e Arquivos de Amostra

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

Conclusão

Em poucas palavras, exploramos detalhadamente a conversão de páginas da Web HTML e arquivos Markdown. A API pode converter esses arquivos de forma rápida e eficiente com chamadas de API simples. Além disso, você pode aprender outros recursos visitando a 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