Преобразование HTML Markdown C#

Markdown — это язык разметки с простыми символами, которые обозначают заголовок, жирный шрифт, курсив, подчеркивание и многое другое. Его легко изучать и писать, поэтому в основном онлайн-документация и файлы readme пишутся с использованием уценки. Вы можете легко преобразовать уценку в веб-страницу HTML, выполнив несколько быстрых шагов. Точно так же преобразование HTML в уценку также является полезной функцией, которую мы будем изучать здесь с использованием языка 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. Установите переменные флага в свойстве «Функции».
  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)";
// Создайте файл уценки
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 для тестирования функций.

Заключение

Короче говоря, мы подробно изучили преобразование файлов HTML Webpage и Markdown. API может быстро и эффективно преобразовывать эти файлы с помощью простых вызовов API. Кроме того, вы можете узнать о других функциях, посетив Документацию по продукту и Справочные материалы по API. Однако, если у вас возникнут какие-либо вопросы, свяжитесь с нами через Форум бесплатной поддержки.

Смотрите также