Markdown в изображение на Java – PNG, JPG, BMP, GIF, TIFF

Преобразование Markdown в изображение может быть полезно, если вы хотите создать визуальное представление своего контента, поделиться им в социальных сетях, встроить его в веб-сайты или сообщения в блогах или использовать его как часть презентации. Библиотека Aspose.HTML для Java предоставляет широкий спектр преобразований Markdown в изображения, такие как JPG, PNG, BMP, TIFF, и GIF. Преобразование Markdown в любой поддерживаемый формат изображения выполняется с помощью тех же обязательных шагов:

Откройте файл Markdown.
Преобразование файла Markdown в HTML-документ.
Создайте объект ImageSaveOptions.
Преобразование HTML-документа в выбранный формат изображения.

Единственное отличие заключается в указании формата выходного изображения с помощью класса ImageSaveOptions. Конструктор ImageSaveOptions(format) инициализирует объект параметров с указанием формата. Вы можете установить формат изображения JPG, PNG, BMP, GIF или TIFF. Формат изображения по умолчанию – PNG.

В этой статье вы найдете информацию о том, как преобразовать Markdown в изображение с помощью Aspose.HTML для Java и как применить ImageSaveOptions Вы можете легко использовать примеры Java для преобразования Markdown в изображения, подробно описанные здесь для преобразования Markdown в PNG, JPG, BMP, GIF и TIFF. Просто установите ImageFormat в ImageSaveOptions!

Если в вашем сценарии требуется рендеринг документа Markdown, например, в формат файла изображения, следующий пример демонстрирует, насколько это просто.

Markdown в PNG

Статические методы класса Converter в основном используются как самый простой способ конвертировать файл Markdown в различные форматы. Вы можете преобразовать Markdown в изображение в своем Java-приложении буквально с помощью нескольких строк кода!

Подготовьте пути для исходного файла Markdown – sourcePath и сохранения преобразованного файла – savePath.
Используйте метод convertMarkdown(sourcePath) для преобразования Markdown в документ HTML.
Создайте новый объект ImageSaveOptions. ImageFormat.Png будет использоваться как формат изображения по умолчанию.
Используйте метод сonvertHTML(document, options, savePath) класса Converter для сохранения промежуточного HTML-документ в виде изображения PNG. Метод принимает в качестве параметров «document», «options» и «savePath» и выполняет преобразование.

Если в вашем сценарии требуется рендеринг документа Markdown, например, в формат файла PNG, следующий пример демонстрирует, насколько это просто:

 1    // Prepare a path to a source Markdown file
 2    String sourcePath = Path.combine(getDataDir(), "document.md");
 3
 4    // Prepare a path for converted file saving 
 5    String savePath = Path.combine(getOutputDir(), "output.png");
 6
 7    // Convert Markdown to HTML
 8    final HTMLDocument document = com.aspose.html.converters.Converter.convertMarkdown(sourcePath);
 9    try {
10        // Convert HTML document to PNG image file format
11        com.aspose.html.converters.Converter.convertHTML(document, new ImageSaveOptions(), savePath);
12    }
13    finally { if (document != null) document.dispose(); }

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

Aspose.HTML для Java предоставляет возможность программного преобразования Markdown в изображение с полным контролем над различными параметрами преобразования с помощью ImageSaveOptions. Эта функция позволяет пользователям настраивать процесс рендеринга, устанавливая формат изображения, размер страницы, поля, уровень сжатия, тип мультимедиа CSS и другие параметры.

Method	Description
setCompression(value)	Sets the Tagged Image File Format (TIFF) Compression. By default this property is `Compression.LZW`.
getCss	Gets a CssOptions object which is used for configuration of CSS properties processing.
setFormat(value)	Sets ImageFormat (JPG, PNG, BMP, TIFF, or GIF). By default this property is `ImageFormat.Png`.
setBackgroundColor(value)	Sets Color which will fill background of every page. Default value is `Color.Transparent(Color.getTransparent())`.
setPageSetup(value)	Gets a page setup object is used for configuration output page-set.
setHorizontalResolution(value)	Sets horizontal resolution for output images in pixels per inch. The default value is 300 dpi.
setVerticalResolution(value)	Sets vertical resolution for output images in pixels per inch. The default value is 300 dpi.
setSmoothingMode(value)	Sets the rendering quality for this image.
getText()	Gets a TextOptions object which is used for configuration of text rendering.

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

Конвертировать Markdown в JPG с использованием ImageSaveOptions

Aspose.HTML для Java позволяет конвертировать Markdown в изображение, используя стандартные или пользовательские параметры сохранения. Установка различных параметров класса ImageSaveOptions дает вам возможность управлять размером страницы, полями, цветом фона и настройками разрешения для выходного изображения.

Это шаги для преобразования файла Markdown в формат JPG с указанием ImageSaveOptions:

Подготовьте исходный путь – sourcePath, чтобы открыть существующий файл Markdown.
Используйте метод convertMarkdown(sourcePath) для преобразования Markdown в документ HTML.
Создайте новый объект ImageSaveOptions с JPG ImageFormat и укажите необходимые параметры сохранения:
- Используйте метод setSmoothingMode(), чтобы установить высокое качество сглаживания изображения.
- Используйте методы setHorizontalResolution() и setVerticalResolution(), чтобы установить горизонтальное и вертикальное разрешение изображения на 200.
- Используйте метод setAnyPage() для установки размера изображения и полей.
Используйте метод convertHTML(document, options, savePath), чтобы сохранить файл Markdown как изображение JPG. Метод принимает документ, параметры, путь к выходному файлу savePath и выполняет операцию преобразования.

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

 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 savePath = Path.combine(getOutputDir(), "nature-options.jpg");
 6
 7    // Convert Markdown to HTML
 8    HTMLDocument document = Converter.convertMarkdown(sourcePath);
 9
10    try {
11        // Initialize ImageSaveOptions
12        ImageSaveOptions options = new ImageSaveOptions(ImageFormat.Jpeg);
13        options.setSmoothingMode(SmoothingMode.HighQuality);
14        options.setHorizontalResolution(new Resolution(200, UnitType.AUTO));
15        options.setVerticalResolution(new Resolution(200, UnitType.AUTO));
16        options.getPageSetup().setAnyPage(new Page(new com.aspose.html.drawing.Size(600, 950), new Margin(30, 20, 10, 10)));
17
18        // Convert HTML document to JPG image file format
19        com.aspose.html.converters.Converter.convertHTML(document, options, savePath);
20    }
21    finally { if (document != null) document.dispose(); }

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

Aspose.HTML предлагает бесплатный онлайн Markdown to Image Converter, который конвертирует Markdown в JPG с высоким качеством, легко и быстро. Если вам нужно включить файлы Markdown в презентацию PowerPoint или отправить их по электронной почте, преобразуйте их в соответствующий формат изображения и используйте по своему усмотрению! Просто загрузите, конвертируйте ваши файлы и получите результат за несколько секунд!

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