Markdown 因其简单易学、创作高效、兼容性强等特点，已成为编写结构化文本的常见选择，广泛用于文档、README 文件和笔记记录等。然而，当追求内容与格式在跨平台环境下的高度统一性，或需应对更为复杂的内容创作需求时，将 Markdown 格式转换为 PDF 等固定布局文档则是更好的选择。将 Markdown 文件转化为 PDF 文档，不仅使文件在各种设备上呈现效果更加一致，还让文档更为正式，更适合用于制作报告、手册，或是与不了解 Markdown 格式的普通读者分享。

本文将介绍如何使用 Spire.Doc for Python 通过 Python 代码将 Markdown 文件转换为 PDF 文档。

• 用 Python 将 Markdown 文件转换为 PDF 文档
• 将 Markdown 转换为 PDF 并自定义页面设置

安装 Spire.Doc for Python

本教程需要 Spire.Doc for Python 和 plum-dispatch v1.7.4。您可以通过以下 pip 命令将它们轻松安装到 Windows 中。

pip install Spire.Doc

如果您不确定如何安装，请参考：如何在 Windows 中安装 Spire.Doc for Python

用 Python 将 Markdown 文件转换为 PDF 文档

开发人员可以使用 Spire.Doc for Python 中的 Document.LoadFromFile(string: fileName, FileFormat.Markdown) 方法加载指定 Markdown 文件，然后使用 Document.SaveToFile(string: fileName, FileFormat.PDF) 方法将文件保存为 PDF 文档。此外，开发人员还可以通过指定 FileFormat 枚举类的枚举项，将 Markdown 文件转换为 HTML、XPS 和 SVG 等格式的文档。

将 Markdown 文件转换为 PDF 文档的详细步骤如下：

• 创建 Document 类的实例。
• 使用 Document.LoadFromFile(string: fileName, FileFormat.Markdown) 方法加载 Markdown 文件。
• 使用 Document.SaveToFile(string: fileName, FileFormat.PDF) 方法将 Markdown 文件转换为 PDF 文档并保存。

from spire.doc import *
from spire.doc.common import *

# 创建一个 Document 类的对象
doc = Document()

# 加载一个 Markdown 文件
doc.LoadFromFile("示例.md", FileFormat.Markdown)

# 将文件保存为 PDF 文档
doc.SaveToFile("output/Markdown转PDF.pdf", FileFormat.PDF)

doc.Dispose()

将 Markdown 转换为 PDF 并自定义页面设置

Spire.Doc for Python 还支持在将 Markdown 文件转换为 PDF 等格式之前进行一些基本的页面设置，从而对转换后文档的外观进行定制。

将 Markdown 文件转换为 PDF 文档并自定义页面设置的详细步骤如下：

• 创建 Document 类的实例。
• 使用 Document.LoadFromFile(string: fileName, FileFormat.Markdown) 方法加载 Markdown 文件。
• 使用 Document.Sections.get_Item() 方法获取默认节。
• 通过 Section.PageSetup 属性获取页面设置，并通过 PageSetup 类下的属性设置页面大小、方向和页边距。
• 使用 Document.SaveToFile(string: fileName, FileFormat.PDF) 方法将 Markdown 文件转换为 PDF 文档并保存。

from spire.doc import *
from spire.doc.common import *

# 创建一个 Document 类的实例
doc = Document()
# 加载一个 Word 文档
doc.LoadFromFile("示例.md", FileFormat.Markdown)

# 获取默认的节（section）
section = doc.Sections.get_Item(0)

# 获取页面设置
pageSetup = section.PageSetup

# 自定义页面设置
pageSetup.PageSize = PageSize.A4()
pageSetup.Orientation = PageOrientation.Landscape
pageSetup.Margins.All = 50

# 将 Markdown 文档保存为 PDF 文件
doc.SaveToFile("output/Markdown转PDF自定义页面.pdf", FileFormat.PDF)

doc.Dispose()

申请临时 License

如果您希望删除结果文档中的评估消息，或者摆脱功能限制，请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。