Конвертировать 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, следующий пример демонстрирует, насколько это просто:

1. Загрузите исходный документ Markdown. В этом примере мы создаем файл Markdown из кода.
2. Конвертируйте Markdown в HTML. Используйте метод convert_markdown(), чтобы сохранить Markdown как документ HTML.
3. Создайте новый объект PdfSaveOptions и укажите необходимые свойства.
4. Используйте метод convert_html() класса Converter. Вам необходимо передать HTMLDocument, PdfSaveOptions и путь к выходному файлу save_path методу Convert_html().

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

# Convert Markdown to PDF in Python

import os
import aspose.html.converters as conv
import aspose.html.saving as sav

# Prepare input and output paths
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)
source_path = os.path.join(output_dir, "document.md")
save_path = os.path.join(output_dir, "markdown-to-pdf.pdf")

# Create the Markdown file
code = "### Hello, World!\nConvert Markdown to PDF!"
with open(source_path, "w", encoding="utf-8") as file:
    file.write(code)

# Convert Markdown to HTML
with conv.Converter.convert_markdown(source_path) as document:
    # Configure PDF output
    options = sav.PdfSaveOptions()

    # Convert HTML to PDF
    conv.Converter.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:

# Convert Markdown to PDF in Python with custom settings

import os
import aspose.html.converters as conv
import aspose.html.drawing as dr
import aspose.html.rendering as ren
import aspose.html.saving as sav

# Prepare input and output paths
output_dir = "output"
input_dir = "data"
if not os.path.exists(output_dir):
    os.makedirs(output_dir)
document_path = os.path.join(input_dir, "document.md")
save_path = os.path.join(output_dir, "md-to-pdf-with-save-options.pdf")

# Convert Markdown to HTML
with conv.Converter.convert_markdown(document_path) as document:
    # Configure PDF output
    options = sav.PdfSaveOptions()
    options.page_setup.any_page = dr.Page(dr.Size(300, 300), dr.Margin(30, 10, 10, 10))
    options.css.media_type = ren.MediaType.PRINT
    options.jpeg_quality = 100

    # Convert HTML to PDF
    conv.Converter.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 = sav.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 бесплатно прямо сейчас!