Зображення в 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 з нуля та додавання до нього зображення.

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

    // 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:

Код C# для створення зображення Markdown як посилання

    // 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.


FAQ

1. Як я можу створювати, аналізувати та редагувати Markdown у C#?

Бібліотека Aspose.HTML for .NET – це окреме рішення для роботи з документами Markdown, яке не залежить від іншого програмного забезпечення. Установіть нашу бібліотеку C#, додайте посилання на бібліотеку до свого проекту C# та програмно працюйте з документами Markdown.

2. Чому Markdown такий популярний?

Markdown дуже популярний серед авторів, розробників і творців контенту завдяки своїй універсальності. Його переваги включають легкий у вивченні та використанні синтаксис, портативність, гнучкість, читабельність і зручність використання. Markdown простий та інтуїтивно зрозумілий і може бути конвертований у HTML, PDF або інші формати.

3. Чи можу я працювати з файлами Markdown на Linux, Mac OS, Android або iOS?

Ви можете працювати з документами Markdown у будь-якій операційній системі, незалежно від того, використовуєте ви Windows, Mac OS, Linux, Android або iOS.

4. Які формати файлів можна обробляти за допомогою бібліотеки Aspose.HTML C#?

Ми підтримуємо кілька форматів файлів, які ви можете створювати, відкривати, аналізувати, редагувати, зберігати або конвертувати на C#. Це формати HTML, XHTML, MHTML і Markdown.



Початок роботи з Aspose.HTML for .NET API

Ви можете скористатися кількома способами інсталяції бібліотеки Aspose.HTML for .NET у вашій системі:

  1. Установіть пакет NuGet за допомогою графічного інтерфейсу користувача NuGet Package Manager.
  2. Встановіть пакет NuGet за допомогою консолі диспетчера пакетів. Ви можете використати таку команду PM> Install-Package Aspose.Html.
  3. Установіть Aspose.HTML for .NET через MSI.

Ця бібліотека підтримує аналіз HTML5, CSS3, SVG і HTML Canvas для створення об’єктної моделі документа (DOM) на основі стандарту WHATWG DOM. Aspose.HTML for .NET повністю написаний на C# і може використовуватися для створення будь-якого типу 32-розрядних або 64-розрядних додатків .NET, включаючи ASP.NET, WCF, WinForms і .NET Core. Перш ніж запустити приклад коду перетворення .NET, переконайтеся, що у вас ОС, як-от Microsoft Windows, або сумісна з .NET Framework або .NET Standard, і середовище розробки, як-от Microsoft Visual Studio. Додаткову інформацію про встановлення бібліотеки C# та системні вимоги ви знайдете у документації Aspose.HTML.


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

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

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