Python 实现 Word 到 Markdown 的转换

在文档管理、内容发布等场景中，将 Word（.doc/.docx）转换为 Markdown 格式是常见需求。Markdown 的轻量、跨平台、易编辑特性，使其更适配网页发布、版本控制等场景。Free Spire.Doc for Python 作为一款免费的 Word 文档处理库，无需依赖 Office 客户端即可实现格式转换，本文将介绍如何使用该 Python 库将 Word 文档转换为 Markdown 格式。

一、工具简介

Free Spire.Doc for Python 是一款免费的 Word 文档处理库，支持 Word 文档的创建、编辑、格式转换等核心功能。该库的核心优势是轻量化、API 简洁，非商业场景下完全免费；同时也存在免费版功能限制，需结合实际需求选择。

安装方法：

通过pip命令一键安装：

sh 复制代码

pip install spire.doc.free

二、核心转换实现

1. 基础单文件转换

最简化的 Word 转 Markdown 代码仅需5行，核心是 Document 类和 SaveToFile 方法：

python 复制代码

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

# 1. 初始化文档对象并加载Word文件
doc = Document()
doc.LoadFromFile("input.docx")  # 替换为你的Word文件路径

# 2. 保存为Markdown格式
doc.SaveToFile("output.md", FileFormat.Markdown)

# 3. 释放资源
doc.Close()

关键说明：

支持 .doc 和 .docx 格式，无需额外处理；
FileFormat.Markdown 是固定枚举值，指定输出格式。

2. 批量转换Word文件

若需转换文件夹下所有 Word 文件，可结合 os 模块实现批量处理：

python 复制代码

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

# 配置源文件夹和目标文件夹
SOURCE_DIR = "./word_docs"  # 存放Word文件的文件夹
TARGET_DIR = "./md_docs"    # 输出Markdown的文件夹

# 创建目标文件夹（不存在则新建）
if not os.path.exists(TARGET_DIR):
    os.makedirs(TARGET_DIR)

# 遍历源文件夹中的Word文件
for filename in os.listdir(SOURCE_DIR):
    # 仅处理.doc/.docx文件
    if filename.endswith((".doc", ".docx")):
        # 构建文件路径
        word_path = os.path.join(SOURCE_DIR, filename)
        md_filename = os.path.splitext(filename)[0] + ".md"
        md_path = os.path.join(TARGET_DIR, md_filename)
        
        # 执行转换
        doc = Document()
        try:
            doc.LoadFromFile(word_path)
            doc.SaveToFile(md_path, FileFormat.Markdown)
            print(f"✅ 成功转换：{filename} → {md_filename}")
        except Exception as e:
            print(f"❌ 转换失败 {filename}：{str(e)}")
        finally:
            doc.Close()  # 无论成败，均释放资源

注意：Word 文档中的图片默认会以 Base64 编码嵌入 Markdown 文档。

三、工具特性分析

优点

免费且轻量：非商业场景无付费门槛，无需安装 Office/WPS，纯 Python 环境即可运行；
基础格式兼容性好：能精准保留标题、列表、普通表格、图片等基础格式，满足大部分日常需求；
API简洁易上手：核心方法仅需几行代码，无需深入理解 Word 文档结构；
跨平台支持：适配 Windows/macOS/Linux，无需针对不同系统修改核心代码。

局限性

免费版页数限制：单文档限制 500 个段落、25个表格；
复杂格式支持不足：对嵌套表格、SmartArt图形、数学公式、宏、自定义样式的转换效果差，易出现格式错乱；
跨平台细节问题：Linux/macOS下对中文特殊字体的渲染不如Windows，可能出现字体丢失；

四、总结

Free Spire.Doc for Python 是一款"够用且易用"的轻量化工具，适合中小规模、非复杂格式的 Word 转 Markdown 场景（如博客文章、简单说明文档）。其优势在于零成本、低学习门槛，能快速解决大部分基础转换需求。