使用Python如何将 Markdown转换为 Word 文档_Python

在当今的技术文档工作流中，markdown 因其简洁的语法和版本控制友好的特性，已成为开发者和技术写作者的首选格式。然而，在企业环境中，word 文档仍然是正式报告、客户交付物和标准化文档的主流格式。

本文将分享如何使用 free spire.doc for python—一款免费的 python 文档处理库，快速实现 markdown 到 word 的转换，涵盖基础转换、批量处理等实用场景，新手也能轻松上手。

一、环境准备

free spire.doc for python 是免费 python 文档处理库，无需依赖 microsoft word，支持 word 文档的创建、编辑、转换等操作，其中内置的 markdown 解析能力，能高效实现 markdown 到 doc/docx 格式的转换，且兼容常见的 markdown 语法（标题、列表、图片、链接等）。

安装：
打开终端/命令提示符，执行以下pip安装命令：

pip install spire.doc.free

二、基础实现：单篇 markdown 转 word

场景1：将 markdown 文本直接转换为 word

适用于 markdown 内容较短、无需读取文件的场景，核心代码如下：

from spire.doc import *
from spire.doc.common import *
# 1. 定义要转换的markdown文本（涵盖常见语法）
markdown_text = """
# 一级标题：markdown转word测试
## 二级标题：功能演示
### 三级标题：基础语法支持
#### 1. 段落与强调
这是一段普通段落，支持**粗体**、*斜体*、`行内代码`，以及[超链接](https://www.google.com/)。
#### 2. 列表
- 无序列表项1
- 无序列表项2
  - 子列表项
1. 有序列表项1
2. 有序列表项2
#### 3. 代码块
```python
print("hello, markdown to word!")
a = 1 + 2
```
"""
# 1. 将markdown文本写入md文档
markdown_path = "input.md"
with open(markdown_path, 'w', encoding='utf-8') as f:
    f.write(markdown_text)
# 2. 创建document对象
doc = document()
# 3. 加载md文档
doc.loadfromfile(markdown_path, fileformat.markdown)
# 4. 保存为word文档（支持.doc和.docx格式）
output_path = "markdown转word.docx"
doc.savetofile(output_path, fileformat.docx)
# 5. 释放资源
doc.close()
print(f"转换完成！word文档已保存至：{output_path}")

场景2：读取 markdown 文件转换为 word

适用于已有.md文件的场景（如test.md），代码更简洁：

from spire.doc import document
from spire.doc import fileformat
# 1. 创建document对象
doc = document()
# 2. 直接加载markdown文件（指定文件路径）
markdown_file_path = "test.md"
doc.loadfromfile(markdown_file_path, fileformat.markdown)
# 3. 保存为word文档
output_path = "markdown转word.docx"
doc.savetofile(output_path, fileformat.docx)
# 4. 释放资源
doc.close()
print(f"文件转换完成！路径：{output_path}")

代码关键说明：

document()：创建一个空的 word 文档对象，是所有操作的核心载体；
loadfromfile()：加载 markdown 文件，第二个参数 fileformat.markdown 指定解析格式；
savetofile()：接收输出路径和文件格式（fileformat.docx/fileformat.doc），完成保存；
close()：释放文档资源，避免内存占用。

三、批量转换多个 markdown 文件

free spire.doc for python 支持批量转换一个文件夹中的多个 markdown 文档。

import os
from spire.doc import document
from spire.doc import fileformat
# 1. 定义markdown文件所在文件夹和输出文件夹
md_folder = "./markdown_files"
output_folder = "./word_files"
# 2. 创建输出文件夹（若不存在）
if not os.path.exists(output_folder):
    os.makedirs(output_folder)
# 3. 遍历文件夹中的所有.md文件
for filename in os.listdir(md_folder):
    if filename.endswith(".md"):
        # 拼接文件路径
        md_path = os.path.join(md_folder, filename)
        # 生成输出word文件名（替换后缀为.docx）
        output_filename = os.path.splitext(filename)[0] + ".docx"
        output_path = os.path.join(output_folder, output_filename)
        # 4. 转换逻辑
        doc = document()
        doc.loadfromfile(md_path, fileformat.markdown)
        doc.savetofile(output_path, fileformat.docx)
        doc.close()
        print(f"已转换：{filename} -> {output_filename}")
print("所有markdown文件批量转换完成！")