markdown 因其简单易学、创作高效、兼容性强等特点，已成为编写结构化文本的常见选择，广泛用于文档、readme 文件和笔记记录等。然而，当追求内容与格式在跨平台环境下的高度统一性，或需应对更为复杂的内容创作需求时，将 markdown 格式转换为 pdf 等固定布局文档则是更好的选择。将 markdown 文件转化为 pdf 文档，不仅使文件在各种设备上呈现效果更加一致，还让文档更为正式，更适合用于制作报告、手册，或是与不了解 markdown 格式的普通读者分享。
本文将介绍如何使用 spire.doc for python 通过 python 代码将 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 文档并保存。
- python
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 文档并保存。
- python
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 天的临时许可证。
