Python实现将Markdown转换为Word/PDF的教程

Markdown 作为一种标记语言文本，具备易编辑、文件轻量化以及高兼容性等显著特性，在技术文档撰写、博客笔记记录和项目说明编写等场景中被大量使用。但在某些特定情况下，我们需要把 Markdown 格式转换为 Word 或者 PDF 这种更为正式、方便分享或打印的文档格式，像撰写用于交付的文档、提交工作报告、发送给客户查阅等场景就属于此类。

如果你期望快速实现格式转换，又不想耗费时间手动调整排版样式，那借助代码来完成转换任务，就是一个既节省时间又可靠的办法。在接下来的教程中，我们将一同探索如何运用几行简洁的 Python 代码，将 Markdown 轻松转换为 Word 和 PDF 格式，帮助你高效且轻松地完成整个转换流程。

需要注意的是本文使用的 Python 库是 Free Spire.Doc for Python，这是 Spire.Doc 的免费版，具有和商业版同样的功能，但更加适合小型项目或测试。你可以通过 pip install Spire.Doc.Free 来安装它，或者导航到官网，下载安装包进行自定义安装。

Python 转换 Markdown 为 Word 文档分三步

相比 Markdown 文档，Word 的可读性和在正式场合中的认可度都更高，因此许多报告或需要对外展示的内容通常都以 Word 格式呈现。然而 Markdown 本身并不能直接保存为 Word 文件。好在我们可以借助 Python 和 Free Spire.Doc 来轻松完成格式转换。

整个流程非常简单：先创建一个 Document 对象，接着加载需要转换的 Markdown 文件，最后通过 Document.SaveToFile() 方法将内容导出为 Word 文档，你可以根据需求选择保存为 .doc 或 .docx 格式。下面是完整的将 Markdown 文档转换为 .doc 和 .docx 后缀的 Word 文档代码示例。

代码示例：

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

# 创建 Document 类的对象
document = Document()
# 加载 Markdown 文件
document.LoadFromFile("E:/Administrator/Python1/input/全球旅游.md")

# 将 Markdown 文件保存为 Word DOCX 文件
document.SaveToFile("E:/Administrator/Python1/output/Md 转 Docx.docx", FileFormat.Docx)
# 将 Markdown 文件保存为 Word DOC 文件
document.SaveToFile("E:/Administrator/Python1/output/Md 转 Doc.doc", FileFormat.Doc)
document.Close()

下方是原始 Markdown 文档与输出文档的对比图：

如果你希望进行批量的转换，建议先将 Markdown 文档放到同一个文件夹中，方便进行遍历，下面是你可以参考的代码：

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

# 要批量转换的 Markdown 文件名称
file_names = [
    "全球旅游.md",
    "欧洲景点.md",
    "亚洲推荐景点.md"
]

# 指定输入与输出目录
input_dir = "E:/Administrator/Python1/input/"
output_dir = "E:/Administrator/Python1/output/"

for name in file_names:
    # 创建 Document 对象
    document = Document()
    
    # 加载 Markdown 文件
    document.LoadFromFile(input_dir + name)
    
    # 输出文件名（将 .md 替换为 .docx）
    output_name = name.replace(".md", ".docx")
    
    # 保存为 Word DOCX
    document.SaveToFile(output_dir + output_name, FileFormat.Docx)
    
    # 关闭文档
    document.Close()

Python 快速将 Markdown 转换为 PDF 文档

在许多日常工作场景中，PDF 往往比 Markdown 更适合作为最终交付格式，无论是用于分享、展示，还是打印都更加稳定可靠。借助 Free Spire.Doc，你同样可以轻松完成 Markdown 转 PDF 的操作。整体步骤并不复杂：创建一个 Document 对象，将 Markdown 文件加载进去，最后通过 Document.SaveToFile() 导出为 PDF 即可。下面的示例代码将展示如何快速完成这一转换过程。

代码示例

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

# 创建 Document 类的对象
document = Document()
# 加载 Markdown 文件
document.LoadFromFile("E:/Administrator/Python1/input/全球旅游.md")

# 将文件保存为 PDF 文档
document.SaveToFile("E:/Administrator/Python1/output/Markdown 转 PDF.pdf", FileFormat.PDF)

document.Close()

在转换时进行 PDF 页面设置

除了将 Markdown 直接转换为 PDF 之外，Free Spire.Doc 还可以在转换过程中对 PDF 的页面进行灵活设置，包括页面大小、方向以及页边距等。通过在生成阶段就完成这些参数的配置，你可以省去后续在其他软件中进行二次调整的步骤，大幅提升工作效率。这样，转换后的 PDF 能够更符合你的排版需求，也更便于直接使用或分享。

Markdown 转 PDF 并设置页面大小、方向和页边距

代码示例

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

# 创建一个 Document 类的实例
doc = Document()
# 加载一个 Word 文档
doc.LoadFromFile("E:/Administrator/Python1/input/全球旅游.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("E:/Administrator/Python1/output/Markdown 转 PDF 自定义页面.pdf", FileFormat.PDF)

doc.Dispose()

结语

本教程详细展示了如何运用 Python 实现 Markdown 格式到 Word 及 PDF 格式的高效转换，同时还深入讲解了如何应对批量处理文件以及调整 PDF 页面设置等常见操作需求。无论是在进行文档传输、正式场合的文档展示，还是日常的文档存档工作，掌握这些技能都能极大地提高你的工作效率。借助 Free Spire.Doc 工具，你不仅能轻松实现格式转换，而且能确保转换后的文档质量稳定、操作流程便捷、数据安全可靠。

以上关于Python实现将Markdown转换为Word/PDF的教程的文章就介绍到这了，更多相关内容请搜索码云笔记以前的文章或继续浏览下面的相关文章，希望大家以后多多支持码云笔记。