Imagem em Markdown em C#

Imagem em Markdown via C#

As imagens podem ser adicionadas a qualquer arquivo Markdown usando Markdown Syntax. Neste artigo, você aprenderá como adicionar imagens no Markdown, mostrar imagens como links e adicionar altText a imagens do Markdown usando C#. A biblioteca Aspose.HTML for .NET é uma solução independente que permite analisar e manipular arquivos Markdown sem usar outro software. Você pode criar um documento Markdown do zero, abrir a partir de um arquivo local e manipular inserindo novos elementos, removendo ou editando o conteúdo de nós existentes.
Use o Aspose.Html.Toolkit.Markdown.Syntax e Aspose.Html.Toolkit.Markdown.Parser namespaces para fornecer análise Markdown completa e gerenciamento de árvore de sintaxe MD com base na especificação GitHub Flavored Markdown (GFM).

Como adicionar imagem no Markdown usando C#

Usando a biblioteca C#, você pode editar arquivos MD programaticamente – altere a estrutura e o conteúdo do documento. Vejamos como criar um novo documento Markdown do zero e adicionar uma imagem a ele.

    // Create the MarkdownSyntaxTree
    var md = new MarkdownSyntaxTree(new Configuration());

    // Create a Markdown syntax factory
    var mdf = md.SyntaxFactory;

    // Specify an image altText
    var altText = "The San Juan Mountains are beautiful";

    // Specify an image label
    var label = "San Juan Mountains";

    // Specify the path to an image
    var href = "C:/temp/image.png";

    // Create an Image element:
    var image = mdf.InlineImage(altText, href, label);

    // Add the image into MD document
    md.AppendChild(image);

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

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

Etapas para adicionar uma imagem ao arquivo MD em C#

Algumas etapas simples para criar uma imagem Markdown:

1. Crie o MarkdownSyntaxTree usando o construtor MarkdownSyntaxTree().
2. Use a propriedade SyntaxFactory para obter a fábrica para criar a árvore de sintaxe Markdown.
3. Especifique um altText de imagem, rótulo e caminho para a imagem e passe-os para InlineImage().
4. Crie um elemento Image usando o construtor InlineImage() em SyntaxFactory.
5. Chame o método AppendChild() da classe MarkdownSyntaxNode para adicionar a imagem ao MD árvore de sintaxe.

Adicionar uma imagem Markdown como um link em C#

O seguinte exemplo de código C# mostra como adicionar uma imagem como um link no documento MD:

    // Create the MarkdownSyntaxTree
    var markdown = new MarkdownSyntaxTree(new Configuration());

    // Create a link node and add it to Markdown syntax tree
    var link = markdown.SyntaxFactory.InlineLink("", "https://docs.aspose.com/html/", "");
    markdown.AppendChild(link);

    // Markdown Image Link – create an image node and add it as a link
    var image = markdown.SyntaxFactory.InlineImage("Aspose.HTML for .NET", "https://products.aspose.com/html/images/headers/aspose_html-for-net.svg", "C# HTML Parser – Documentation");
    link.AppendChild(image);
            
    // Prepare a path for MD file saving 
    string savePath = Path.Combine(OutputDir, "markdown-image-link.md");

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

Documentação

Para saber mais sobre a API Aspose.HTML, visite nosso guia de documentação. Markdown é uma linguagem de marcação simples que permite formatar texto simples. 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.