Конвертировать 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 path to a source Markdown file
    String sourcePath = Path.combine(getOutputDir(), "document.md");

    // Prepare a simple Markdown example
    String code = StringExtensions.concat("### Hello, World!", 
                "\r\n", 
                "[visit applications](https://products.aspose.app/html/applications)");
    // Create a Markdown file
    com.aspose.html.internal.ms.System.IO.File.writeAllText(sourcePath, code);            

    // Convert Markdown to HTML 
    HTMLDocument document = Converter.convertMarkdown(sourcePath);

    // Prepare a path for converted PDF file saving
    String savePath = Path.combine(getOutputDir(), "document-output.pdf");

    try {
        // Convert the HTML document to PDF file format
        com.aspose.html.converters.Converter.convertHTML(document, new PdfSaveOptions(), savePath);
    }
    finally { if (document != null) document.dispose(); }    

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

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

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

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 для 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 с пользовательскими разрешениями и цветом фона:

    // Prepare a path to a source Markdown file
    String sourcePath = Path.combine(getDataDir(), "nature.md");

    // Prepare a path for converted PDF file saving 
    String savePath = Path.combine(getOutputDir(), "nature-output.pdf");

    // Convert Markdown to HTML
    HTMLDocument document = Converter.convertMarkdown(sourcePath);
    try {
        // Initialize PdfSaveOptions. Set up the resolutions and change the background color to AliceBlue
        PdfSaveOptions options = new PdfSaveOptions();
        options.setHorizontalResolution(new Resolution(200, UnitType.AUTO));
        options.setVerticalResolution(new Resolution(200, UnitType.AUTO));;
        com.aspose.html.drawing.Color.getAliceBlue().CloneTo(options.getBackgroundColor());

        // Convert the HTML document to PDF file format
        com.aspose.html.converters.Converter.convertHTML(document, options, savePath);
    }
    finally { if (document != null) document.dispose(); }

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