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

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

Примечание. Любое преобразование из Markdown в другие форматы проходит этап Преобразование из Markdown в HTML.

Markdown в PDF

Статические методы класса Converter в основном используются как самый простой способ конвертировать файл Markdown в различные форматы. Давайте рассмотрим пошаговые инструкции для простого сценария преобразования Markdown в PDF:

1. Загрузите файл Markdown. Вы можете загрузить Markdown из файла или потока. В следующем примере мы создаем Markdown с нуля.
2. Используйте метод convertMarkdown(sourcePath) для преобразования Markdown в документ HTML.
3. Создайте новый объект PdfSaveOptions.
4. Используйте метод сonvertHTML(document, options, savePath) класса Converter для сохранения промежуточного HTML-документ в виде файла PDF. Метод принимает в качестве параметров document, options, savePath и выполняет преобразование.

Просмотрите следующий фрагмент кода Java, в котором показан процесс преобразования Markdown в PDF с пошаговыми инструкциями:

// Prepare a simple Markdown example
String code = "### Hello, World! \n\n" +
        "[visit applications](https://products.aspose.app/html/applications)";

// Create a Markdown file
FileHelper.writeAllText($o("document.md"), code);

// Convert Markdown to HTML
HTMLDocument document = Converter.convertMarkdown($o("document.md"));

// Convert the HTML document to PDF file format
Converter.convertHTML(document, new PdfSaveOptions(), $o("document-output.pdf"));

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

Параметры сохранения

Aspose.HTML for Java позволяет конвертировать Markdown в PDF, используя стандартные или пользовательские параметры сохранения. PdfSaveOptions позволяет настроить процесс рендеринга. Вы можете указать размер страницы, поля, права доступа к файлу, MediaType и т. д.

Metod	Description
setJpegQuality(value)	Specifies the quality of JPEG compression for images. The default value is 95.
getCss()	Gets a CssOptions object which is used for configuration of CSS properties processing.
setBackgroundColor(value)	Sets the color that will fill the background of every page. By default, this property is Transparent.
setPageSetup(value)	This method sets a page setup object and uses it for configuration output page-set.
setHorizontalResolution(value)	Sets horizontal resolution for internal images, in pixels per inch. By default this property is 300 dpi.
setVerticalResolution(value)	Sets vertical resolution for output images in pixels per inch. The default value is 300 dpi.
setEncryption	This method gets or sets encryption details. If it is not set, then no encryption will be performed.

Для получения дополнительной информации о том, как настроить процесс преобразования с помощью PdfSaveOptions, вы можете обратиться к статье Fine-Tuning Converters .

Конвертировать Markdown в PDF на Java с использованием PdfSaveOptions

С помощью Aspose.HTML for Java вы можете программно конвертировать файлы с полным контролем над широким диапазоном параметров конвертации. Чтобы преобразовать Markdown в PDF с указанием PdfSaveOptions, вы должны выполнить несколько шагов:

1. Загрузите файл Markdown.
2. Преобразуйте Markdown в HTML, используя один из методов convertMarkdown().
3. Создайте новый объект PdfSaveOptions и укажите необходимые свойства. В следующем примере мы применяем пользовательские разрешения и цвет фона для полученного PDF-документа:
   • Используйте методы setHorizontalResolution() и VerticalResolution(), чтобы установить разрешение по горизонтали и вертикали для выходного файла PDF.
   • Используйте метод setBackgroundColor(), чтобы установить цвет, заполняющий фон.
4. Вызовите метод сonvertHTML(document, options, savePath) класса Converter.

В следующем примере Java показано, как использовать PdfSaveOptions и создать файл PDF с пользовательскими разрешениями и цветом фона:

// Convert Markdown to HTML
HTMLDocument document = Converter.convertMarkdown($i("nature.md"));

// Initialize PdfSaveOptions. Set up the resolutions, JpegQuality and change the background color to AliceBlue
PdfSaveOptions options = new PdfSaveOptions();
options.setHorizontalResolution(Resolution.to_Resolution(200));
options.setVerticalResolution(Resolution.to_Resolution(200));
options.setBackgroundColor(Color.getAliceBlue());
options.setJpegQuality(100);

// Convert the HTML document to PDF file format
Converter.convertHTML(document, options, $o("nature-output.pdf"));

Заключение

Markdown — простой и эффективный язык разметки, но его ограничения в форматировании и оптимизации для печати подчеркивают необходимость преобразования Markdown в более универсальные форматы, такие как PDF. Aspose.HTML for Java предоставляет надежное решение для преобразования Markdown в PDF с использованием промежуточного этапа обработки Markdown в HTML. Благодаря статическим методам в классе Converter и настраиваемым PdfSaveOptions разработчики имеют полный контроль над параметрами преобразования, такими как настройки страницы, качество изображения, цвета фона, разрешения и т. д.

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