API C# para Analisar Arquivos Markdown

Analisar arquivos Markdown usando C#

A biblioteca Aspose.HTML for .NET fornece API de análise Markdown para a plataforma C#. O namespace Aspose.Html.Toolkit.Markdown.Parser contém classes e métodos para fornecer análise Markdown completa e renderização.

Você pode criar, editar, salvar, mesclar, converter arquivos MD em outros formatos de arquivo e adicionar links, listas, blocos de código, imagens e outros elementos em arquivos Markdown seguindo os links:

Como analisar Markdown em C#

A tarefa de editar Markdown programaticamente em C# é modificar elementos na árvore do documento MD. Aspose.HTML for .NET API oferece suporte a um conjunto de elementos MD que são definidos no GitHub Flavored Markdown Spec, juntamente com regras sobre como os elementos podem ser aninhados. Além disso, o namespace Aspose.Html.Toolkit.Markdown.Extensions contém classes e métodos para manipular a sintaxe Markdown árvore baseada em especificações que não fazem parte da especificação GFM. Considere etapas simples para analisar e editar Markdown. Vamos analisar o Markdown e editar o conteúdo de texto nele:

    // Specify the path to the source MD file
    var input = "C:/temp/input.md";

    // Create a MarkdownParser object
    var parser = new MarkdownParser();

    // Parse the MD document and get a syntax tree
    var markdown = parser.ParseFile(input);
    
    // Create a TreeWalker object and navigate through the syntax tree starting at the first node
    using var iterator = markdown.CreateTreeWalker(markdown.FirstChild);
    while (iterator.NextNode() != null)
    {
        // Check the type of the current node as EmphasisSyntax
        if (iterator.CurrentNode is EmphasisSyntaxNode)
        {
            var node = (EmphasisSyntaxNode)iterator.CurrentNode;
            var n = node.FirstChild;
            while (n != null)
            {
                var next = n.NextSibling;
                // Remove the EmphasisSyntax node
                node.RemoveChild(n);
                n = next;
            }

            // Get a SyntaxFactory to create new elements 
            var syntax = markdown.SyntaxFactory;

            // Add the text to a new node
            node.AppendChild(syntax.Text("new text with"));

            // Add whitespase
            node.AppendChild(syntax.Whitespace());

            // Create an emphasis object
            var emphasis = syntax.Emphasis(Emphasis.Strong);

            // Add the text into empasis and accumulate a new node
            emphasis.AppendChild(syntax.Text("strong emphasis!"));
            node.AppendChild(emphasis);
            break;
        }
    }

    // Prepare a path for MD file saving 
    string savePath = Path.Combine(OutputDir, "output-edit.md");

    // Save MD file
    markdown.Save(savePath);
        

Etapas para analisar e editar Markdown em C#

Considere etapas simples para analisar o Markdown e editar o conteúdo de texto existente:

1. Especifique o caminho para o arquivo MD de origem e use o MarkdownParser() para inicializar uma nova instância da classe MarkdownParser.
2. Chame o método ParseFile() para analisar Markdown e obter uma árvore de sintaxe .
3. Crie um objeto TreeWalker e navegue pela árvore de sintaxe Markdown e remova o conteúdo desnecessário – nó EmphasisSyntax.
4. Use a propriedade SyntaxFactory para obter uma fábrica de sintaxe para criar novos elementos.
5. Crie um novo nó de texto e adicione conteúdo de texto à nova ênfase.
6. Use o método AppendChild() para adicionar o novo nó à árvore de sintaxe.
7. Salve o arquivo MD editado com o método Save().

Documentação

Para saber mais sobre a API Aspose.HTML, visite nosso guia de documentação. Você pode baixar os exemplos do repositório GitHub. Eles são de código aberto e podem ser usados ​​livremente em seus próprios aplicativos.

Markdown é uma linguagem de marcação simples que permite formatar texto simples. John Gruber, o autor do MD, projetou a sintaxe de formatação do Markdown com o objetivo de torná-lo o mais legível possível. O Markdown é frequentemente usado como um formato para documentação e arquivos leia-me, pois permite escrever em um estilo fácil de ler e fácil de escrever. O artigo de documentação Sintaxe Markdown fornece informações sobre os principais elementos Markdown, detalhes e exemplos da sintaxe Markdown.

Introdução à API Aspose.HTML for .NET

Você pode usar várias maneiras de instalar a biblioteca Aspose.HTML for .NET em seu sistema:

1. Instale um Pacote NuGet usando a GUI do NuGet Package Manager.
2. Instale um pacote NuGet usando o console do gerenciador de pacotes. Você pode usar o seguinte comando PM> Install-Package Aspose.Html.
3. Instale o Aspose.HTML for .NET através do MSI.
   

Esta biblioteca suporta a análise de HTML5, CSS3, SVG e HTML Canvas para construir um Document Object Model (DOM) baseado no WHATWG DOM Standard. Aspose.HTML for .NET foi totalmente escrito em C# e pode ser usado para criar qualquer tipo de aplicativo .NET de 32 ou 64 bits, incluindo ASP.NET, WCF, WinForms e .NET Core. Antes de executar o código de exemplo de conversão .NET, certifique-se de ter um sistema operacional como o Microsoft Windows ou compatível com .NET Framework ou .NET Standard e o ambiente de desenvolvimento como o Microsoft Visual Studio. Para obter mais detalhes sobre a instalação da biblioteca C# e os requisitos do sistema, consulte Documentação do Aspose.HTML.

Requisitos de sistema

Nossas APIs são suportadas em todas as principais plataformas e sistemas operacionais. Antes de executar o código, verifique se você possui os seguintes pré-requisitos em seu sistema.

• Microsoft Windows ou um sistema operacional compatível com plataformas .NET Framework, .NET Core, Windows Azure, Mono ou Xamarin.
• Ambiente de desenvolvimento como Microsoft Visual Studio.
• Aspose.HTML for .NET DLL referenciado em seu projeto – Instale a partir do NuGet usando o botão Download acima.