Зображення в Markdown на C#

Зображення в Markdown на C#

Зображення можна додавати до будь-якого файлу Markdown за допомогою синтаксису Markdown. У цій статті ви дізнаєтесь про додавання зображень у Markdown, показ зображень як посилань і додавання altText до зображень Markdown за допомогою C#. Бібліотека Aspose.HTML for .NET – це окреме рішення, яке дозволяє аналізувати та маніпулювати файлами Markdown без використання іншого програмного забезпечення. Ви можете створити документ Markdown з нуля, відкрити з локального файлу та маніпулювати, вставляючи нові елементи, видаляючи або редагуючи вміст існуючих вузлів.
Використовуйте Aspose.Html.Toolkit.Markdown.Syntax і Aspose.Html.Toolkit.Markdown.Parser простори імен для забезпечення повного синтаксичного аналізу Markdown і керування синтаксичним деревом MD на основі специфікації GitHub Flavored Markdown (GFM).

Як додати зображення в Markdown за допомогою C#

Використовуючи бібліотеку C#, ви можете програмно редагувати MD-файли – змінювати структуру та вміст документа. Давайте розглянемо створення нового документа Markdown з нуля та додавання до нього зображення.

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

Кроки для додавання зображення до файлу MD на C#

Кілька простих кроків, щоб створити зображення Markdown:

1. Створіть MarkdownSyntaxTree за допомогою конструктора MarkdownSyntaxTree().
2. Використовуйте властивість SyntaxFactory, щоб отримати фабрику для створення синтаксичного дерева Markdown.
3. Укажіть altText зображення, мітку та шлях до зображення та передайте їх у InlineImage().
4. Створіть елемент Image за допомогою конструктора InlineImage() у SyntaxFactory.
5. Викличте метод AppendChild() класу MarkdownSyntaxNode, щоб додати зображення до синтаксичного дерева MD.

Додайте зображення Markdown як посилання

У наступному прикладі коду C# показано, як додати зображення як посилання в документ 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);

Документація

Щоб дізнатися більше про API Aspose.HTML, відвідайте наш посібник із документації. Markdown – це проста мова розмітки, яка дозволяє форматувати звичайний текст. Стаття документації Markdown Syntax містить інформацію про основні елементи Markdown, деталі та приклади синтаксису Markdown.

Установлення Aspose.HTML for .NET

Установіть Aspose.HTML for .NET з NuGet за допомогою .NET CLI:

dotnet add package Aspose.HTML

Також можна скористатися інтерфейсом диспетчера пакетів NuGet або виконати Install-Package Aspose.HTML у консолі диспетчера пакетів. Докладні інструкції наведено в посібнику зі встановлення . Щоб оцінити API без обмежень ознайомлювальної версії, запросіть тимчасову ліцензію .

Системні вимоги

Наші API підтримуються на всіх основних платформах і операційних системах. Перш ніж виконувати код, переконайтеся, що у вашій системі є такі передумови.

• Microsoft Windows або сумісна ОС з платформами .NET Framework, .NET Core, Windows Azure, Mono або Xamarin.
• Середовище розробки, наприклад Microsoft Visual Studio.
• Aspose.HTML for .NET DLL, на який посилається ваш проект – Встановіть із NuGet за допомогою кнопки «Download» вище.