Конвертировать Markdown в HTML на Java

Markdown – это язык разметки с синтаксисом форматирования простого текста. Markdown часто используется в качестве формата для документации и файлов readme, поскольку он позволяет писать в удобном для чтения и написания стиле. Его конструкция позволяет легко преобразовывать его во многие форматы вывода, но изначально он был создан для преобразования только в HTML.

В этой статье содержится информация о том, как преобразовать Markdown в HTML с помощью библиотеки Aspose.HTML для Java. Кроме того, вы рассмотрите примеры Java для иллюстрации сценариев преобразования.

Зачем конвертировать Markdown в HTML?

Markdown – это легкий язык разметки, изначально разработанный для простого преобразования в HTML. Идея заключалась в том, чтобы позволить писателям использовать простой и легкий для изучения синтаксис для форматирования текста, не беспокоясь о сложностях HTML. HTML – это стандартный язык разметки для создания веб-страниц, поэтому преобразование Markdown в HTML упрощает публикацию контента в Интернете.
Aspose.HTML использует преобразование Markdown в HTML в качестве промежуточного шага для преобразования документов Markdown в другие популярные форматы, такие как PDF, XPS и изображения.

Конвертировать Markdown в HTML

Используя библиотеку классов Aspose.HTML в своем Java-приложении, вы можете легко преобразовать Markdown в HTML, написав всего несколько строк кода! Простой способ выполнить преобразование – вызвать метод convertMarkdown(sourcePath, outputPath) , который принимает только путь к исходному файлу Markdown и путь к выходному файлу.

1   // Prepare a path to a source Markdown file
2   String sourcePath = Path.combine(getDataDir(), "nature.md");
3
4   // Prepare a path for converted file saving 
5   String outputPath = Path.combine(getOutputDir(), "nature-output.html");
6
7   // Convert Markdown to HTML
8   com.aspose.html.converters.Converter.convertMarkdown(sourcePath, outputPath);

Давайте посмотрим на другой пример Java. Вы можете подготовить исходный код Markdown с нуля и преобразовать его в HTML:

 1   // Prepare a simple Markdown example
 2   String code = StringExtensions.concat("### Hello, World!", 
 3               "\r\n", 
 4               "[visit applications](https://products.aspose.app/html/applications)");
 5   
 6   // Создаем файл Markdown
 7   com.aspose.html.internal.ms.System.IO.File.writeAllText (исходный путь, код);
 8
 9   // Подготавливаем путь для сохранения сконвертированного файла
10   Строка outputPath = Path.combine(getOutputDir(), "document-output.html");
11
12   // Преобразование Markdown в HTML
13   com.aspose.html.converters.Converter.convertMarkdown (исходный путь, выходной путь);

Aspose.HTML предлагает бесплатный онлайн Конвертер Markdown в HTML, который конвертирует Markdown в HTML с высоким качеством, легко и быстро. Просто загрузите, конвертируйте ваши файлы и получите результат за несколько секунд!

Синтаксис Markdown

В этой статье демонстрируется синтаксис, объявленный в основной спецификации Markdown и GitLab Flavored Markdown вариант. Все эти функции поддерживаются Aspose.HTML из коробки.

Заголовки

Markdown поддерживает два стиля заголовков: Setext и atx:

1This is an H1
2
3=============
4
5This is an H2
6
7-------------

1# This is an H1
2
3## This is an H2
4
5###### This is an H6

Списки

Markdown поддерживает упорядоченные (нумерованные) и неупорядоченные (маркированные) списки. Ненумерованные списки используют звездочки, плюсы и дефисы — взаимозаменяемо – в качестве маркеров списка:

1*   Red
2*   Green
3*   Blue

Нумерованные списки используют числа, за которыми следуют точки:

11.  Bird
22.  McHale
33.  Parish

Изображения

Синтаксис встроенного изображения выглядит следующим образом:

1 ![Alt text](/path/to/img.jpg)

Ссылки

Синтаксис ссылок выглядит так:

1 [an example](http://example.com/ "Title")

Акцент - Emphasis

Markdown рассматривает звездочки * и подчеркивание (_) как индикаторы выделения:

1*single asterisks*
2_single underscores_
3**double asterisks**
4__double underscores__

Цитаты

Markdown использует символы > в стиле электронной почты для блок-цитирования:

1> This is the first level of quoting.
2>
3> > Это вложенная цитата.

Блоки кода

Чтобы указать фрагмент кода, заключите его в обратные кавычки (`):

1 javascript
2
3функция myFunc() {
4
5   Сообщить('Привет Мир!!!');
6
7}
8
9\

Таблицы

Таблицы не являются частью основной спецификации Markdown, но они являются частью GFM:

1| header 1 | header 2 | header 3 |
2| --- | ------ |--------- |
3| cell 1 | cell 2 | cell 3 |

Вы можете скачать полные примеры и файлы данных по адресу GitHub.

Конвертер Markdown Конвертировать Markdown в PDF