Перетворення HTML Markdown C#

Markdown — це мова розмітки з простими символами, які позначають заголовок, жирний шрифт, курсив, підкреслення та багато іншого. Його легко вивчити та написати, тому здебільшого онлайн-документація та файли readme пишуться за допомогою розмітки. Ви можете легко перетворити розмітку на веб-сторінку HTML за допомогою кількох швидких кроків. Подібним чином, перетворення HTML у markdown також є корисною функцією, яку ми досліджуватимемо тут за допомогою мови C#.

Конвертер HTML і Markdown – встановлення API

Ви можете конвертувати веб-сторінку HTML і файли формату Markdown за допомогою мови програмування C#. Вам потрібно встановити Aspose.HTML for .NET API, щоб маніпулювати та перетворювати ці формати файлів. Ви можете встановити API з галереї NuGet за допомогою наступної інсталяційної команди або завантажити файл DLL із розділу Завантаження, щоб додати його як посилання у свій проект.

PM> Install-Package Aspose.Html

Наразі ви зможете налаштувати API протягом кількох хвилин. Розглянемо різні можливі сценарії:

Програмне перетворення веб-сторінки HTML у Markdown (.md) у C#

Ви можете конвертувати веб-сторінку HTML у Markdown у своїх програмах на основі .NET. Ця популярна функція перетворення підтримується таким чином, що вам потрібно лише викликати API, не вдаючись у деталі основних форматів файлів. Тому вам потрібно виконати наведені нижче кроки для перетворення веб-сторінки HTML:

  1. Створіть файл HTML або завантажте наявний вхідний файл
  2. Викличте метод ConvertHTML за допомогою об’єкта MarkdownSaveOptions.
  3. Збережіть вихідний файл Markdown (.md).

Наведений нижче код показує, як перетворити веб-сторінку HTML у Markdown за допомогою C#:

// Підготуйте HTML-код і збережіть його у файлі.
var code = "<h1>Header 1</h1>" +
            "<h2>Header 2</h2>" +
            "<p>Hello World!!</p>";
System.IO.File.WriteAllText(dataDir + "document.html", code);

// Викличте метод ConvertHTML для перетворення HTML у Markdown.
Aspose.Html.Converters.Converter.ConvertHTML(dataDir + "document.html", new Aspose.Html.Saving.MarkdownSaveOptions(), dataDir + "output.md");

Перетворення веб-сторінки HTML на Markdown MD (.md) із додатковими параметрами в C#

Ми вже вивчили простий і базовий варіант використання конвертації HTML у нотацію Markdown. Давайте зробимо ще один крок далі, де ми будемо контролювати процес перетворення. Розглянемо сценарій, коли у файлі HTML багато нерелевантних даних, але нам потрібно лише перетворити вміст на теги абзаців або гіперпосилань. Ми виконаємо наведені нижче дії для розуміння та спробуємо цю функцію:

  1. Завантажте вхідний файл HTML
  2. Ініціалізувати об’єкт MarkdownSaveOptions.
  3. Встановіть змінні Flag у властивості Features
  4. Збережіть вихідний файл Markdown

Наведений нижче код базується на цих кроках, які показують, як перетворити веб-сторінку HTML у Markdown із додатковими параметрами за допомогою C#:

// Підготуйте HTML-код і збережіть його у файлі.
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);

// Створіть екземпляр SaveOptions і налаштуйте правило: 
// - тільки <a>і</a><p> <a>елементів буде перетворено на уцінку.</a>
var options = new Aspose.Html.Saving.MarkdownSaveOptions();
options.Features = Aspose.Html.Saving.MarkdownFeatures.Link | Aspose.Html.Saving.MarkdownFeatures.AutomaticParagraph;

// Викличте метод ConvertHTML, щоб перетворити HTML у Markdown.
Aspose.Html.Converters.Converter.ConvertHTML(dataDir + "document.html", options, dataDir + "output_options.md");

Програмне перетворення Markdown (.md) на веб-сторінку HTML за допомогою C#

У деяких випадках вам може знадобитися конвертувати HTML у нотацію Markdown. Наприклад, деякі розділи документації використовуються у веб-додатках і в багатьох інших випадках використання. Ви можете легко конвертувати файл Markdown у HTML, виконавши такі дії:

  1. Створіть файл Markdown (.md) або завантажте вхідний файл
  2. Збережіть вихідний файл HTML за допомогою методу ConvertMarkdown.

Код нижче показує, як перетворити файл Markdown (.md) на веб-сторінку HTML за допомогою мови програмування C#:

// Підготуйте простий приклад Markdown
var code = "### Hello World" +
            "\r\n" +
            "[visit applications](https://products.aspose.app/html/family)";
// Створіть файл Markdown
System.IO.File.WriteAllText(dataDir + "input_document.md", code);

// Перетворення Markdown на документ HTML
Aspose.Html.Converters.Converter.ConvertMarkdown(dataDir + "input_document.md", dataDir + "MarkdownToHTMLoutput.html");

Завантажте приклад проекту та файли зразків

Ми зібрали зразок проекту для демонстрації вищезгаданих функцій, де ви також можете завантажити зразки файлів. Це консольна програма, яку ви можете спробувати, щоб вивчити та зрозуміти функції уцінки та взаємоперетворення HTML. Тож ви можете завантажити ZIP або клонувати GitHub Repository для тестування функцій.

Висновок

Коротко кажучи, ми детально дослідили перетворення файлів HTML Webpage і Markdown. API може швидко й ефективно конвертувати ці файли за допомогою простих викликів API. Крім того, ви можете дізнатися про інші функції, відвідавши Документація продукту і Посилання на API. Проте, якщо у вас виникли проблеми, зв’яжіться з нами через безкоштовний форум підтримки.

Дивись також