Конвертировать Markdown в PDF на Python
В этой статье представлена информация о том, как конвертировать Markdown в PDF с помощью Aspose.HTML for Python via .NET API. Вы узнаете о поддерживаемых сценариях преобразования Markdown в PDF и рассмотрите примеры Python для их иллюстрации. Кроме того, вы можете попробовать онлайн-конвертер Markdown, чтобы протестировать функциональность Aspose.HTML и конвертировать Markdown на лету.
Онлайн-конвертер Markdown
Вы можете конвертировать Markdown в другие форматы с помощью Aspose.HTML в режиме реального времени. Загрузите файл Markdown, выберите выходной формат и запустите пример. Параметры сохранения настроены по умолчанию. Вы мгновенно получите результат конвертации в виде отдельного файла.
Если вы хотите программно преобразовать Markdown в PDF, ознакомьтесь со следующими примерами кода Python.
Конвертировать Markdown в PDF
Если ваш сценарий требует рендеринга документа Markdown, например, в формат файла PDF, следующий пример демонстрирует, насколько это просто:
- Загрузите исходный документ Markdown. В этом примере мы создаем файл Markdown из кода.
- Конвертируйте Markdown в HTML. Используйте метод convert_markdown(), чтобы сохранить Markdown как документ HTML.
- Создайте новый объект PdfSaveOptions и укажите необходимые свойства.
- Используйте метод convert_html() класса Converter. Вам необходимо передать HTMLDocument, PdfSaveOptions и путь к выходному файлу save_path методу Convert_html().
Если вам нужно создать документ Markdown из пользовательской строки непосредственно в вашем коде и преобразовать его в файл PDF, вам может помочь следующий пример:
1import os
2from aspose.html import *
3from aspose.html.saving import *
4from aspose.html.converters import *
5
6# Prepare a path to a source Markdown file
7output_dir = "output/"
8source_path = os.path.join(output_dir, "document.md")
9
10# Prepare a simple Markdown example
11code = "### Hello, World!\nConvert Markdown to PDF!"
12
13# Create a Markdown file
14with open(source_path, "w") as file:
15 file.write(code)
16
17# Convert Markdown to HTML document
18document = Converter.convert_markdown(source_path)
19
20# Create an instance of PdfSaveOptions
21options = PdfSaveOptions()
22
23# Prepare a path to save the converted file
24save_path = os.path.join(output_dir, "markdown-to-pdf.pdf")
25
26# Convert HTML to PDF
27Converter.convert_html(document, options, save_path)
Конвертировать Markdown в PDF с помощью PdfSaveOptions
Процесс конвертации Markdown в PDF можно гибко настроить. Aspose.HTML for Python via .NET предоставляет класс
PdfSaveOptions, который дает вам больше контроля над сохранением документов в формате PDF. Вот описание свойств, доступных в PdfSaveOptions
:-
page_setup – это свойство обеспечивает доступ к объекту PageSetup, используемому для настройки макета и настроек выходных страниц PDF в соответствии с конкретными требованиями к печати или отображению.
- horizontal_resolution – это свойство управляет горизонтальным разрешением как для внутренних изображений, используемых во время обработки, так и для любых внешних изображений, включенных в HTML. По умолчанию установлено значение 300 dpi.
- vertical_resolution – аналогично свойству
horizontal_resolution
, это свойство управляет вертикальным разрешением внутренних и внешних изображений во время создания PDF-файла. Как и его горизонтальный аналог, по умолчанию оно составляет 300 точек на дюйм. - background_color – это свойство устанавливает или извлекает цвет фона, который заполняет каждую страницу PDF-документа. Значение по умолчанию – transparent, но его можно настроить в соответствии с брендингом или эстетическими предпочтениями, обеспечивая единообразие на всех страницах.
- css – это свойство использует объект CssOptions для настройки обработки свойств CSS во время преобразования HTML в PDF. Это позволяет точно контролировать, как стили HTML интерпретируются и применяются в конечном PDF-файле.
- document_info – это свойство содержит метаданные и информацию о выходном PDF-документе, такую как название, автор, тема и ключевые слова. Эти метаданные помогают управлять документами, индексировать их и обеспечивать возможность поиска, делая PDF-файл более информативным и организованным.
- form_field_behaviour – это свойство определяет поведение полей интерактивной формы в сгенерированном PDF-файле.
- jpeg_quality – это свойство определяет качество сжатия JPEG, используемое для изображений, встроенных в документ PDF. Качество по умолчанию установлено на 95, что обеспечивает хороший баланс между точностью изображения и размером файла. Установка этого свойства позволяет оптимизировать размер файла или качество изображения в соответствии с вашими конкретными потребностями.
- шифрование – это свойство предоставляет подробную информацию о шифровании PDF-документа, включая защиту паролем и настройки разрешений. Если оно не настроено, шифрование не применяется, но установка этого свойства позволяет безопасно распространять и контролировать доступ к конфиденциальному содержимому PDF.
- is_tagged_pdf – если установлено значение true, в PDF-документе создается макет с тегами, что повышает доступность для пользователей с ограниченными возможностями. Это гарантирует, что контент правильно структурирован и доступен для навигации с использованием вспомогательных технологий, а также соответствует стандартам доступности.
Вам следует использовать класс PdfSaveOptions, чтобы указать дополнительные параметры, влияющие на результат сохранения документа в формате PDF. Этот класс содержит свойства, которые определяют, как будет отображаться вывод PDF. В следующем фрагменте кода Python показано, как преобразовать Markdown в PDF с помощью PdfSaveOptions:
1import os
2from aspose.html import *
3from aspose.html.converters import *
4from aspose.html.saving import *
5from aspose.html.drawing import *
6
7# Setup directories and define paths
8output_dir = "output/"
9input_dir = "data/"
10if not os.path.exists(output_dir):
11 os.makedirs(output_dir)
12document_path = os.path.join(input_dir, "document.md")
13save_path = os.path.join(output_dir, "output.pdf")
14
15# Convert Markdown to HTML document
16document = Converter.convert_markdown(document_path)
17
18# Create an instance of PdfSaveOptions
19options = PdfSaveOptions()
20options.page_setup.any_page = Page(Size(300, 300), Margin(10, 10, 10, 10))
21options.css.media_type.PRINT
22options.jpeg_quality = 100
23
24# Convert HTML to PDF
25Converter.convert_html(document, options, save_path)
- Свойство page_setup настраивает параметры макета страницы для выходного PDF-файла, устанавливая размер страницы 300x300 единиц с полями по 10 единиц со всех сторон.
- Для параметра jpeg_quality установлено значение 100, что максимизирует качество любых изображений JPEG, включенных в PDF-файл.
- Для параметра
css.media_type
установлено значение PRINT, что указывает, что во время преобразования следует использовать тип носителя CSS для печати, обеспечивая правильное оформление.
В этом коде класс PdfSaveOptions из Aspose.HTML for Python via .NET используется для настройки преобразования Markdown в PDF.
Эти настройки гарантируют, что полученный PDF-файл будет иметь правильный формат, стиль, подходящий для печати, и будет содержать высококачественные изображения.
Как конвертировать Markdown в XPS
Aspose.HTML for Python via .NET поддерживает преобразование Markdown в XPS. Для этого вам следует использовать
XpsSaveOptions, чтобы получить объект параметров сохранения, который передается методу convert_html()
:
options = XpsSaveOptions()
Использование XpsSaveOptions позволяет настроить процесс рендеринга; вы можете указать свойства page_setup, background_color, css, horizontal_resolution и vertical_resolution.
Загрузите библиотеку Aspose.HTML for Python via .NET, чтобы успешно, быстро и легко конвертировать документы HTML, MHTML, EPUB, SVG и Markdown в самые популярные форматы.
Вы можете проверить качество преобразования Markdown в PDF с помощью нашего онлайн-конвертера Конвертер MD в PDF. Загрузите, конвертируйте файлы и получите результаты через несколько секунд. Попробуйте наш мощный конвертер Markdown в PDF бесплатно прямо сейчас!