Python 批量处理：Markdown 与 HTML 格式相互转换

引言

在多平台内容分发与管理的场景中，文档格式转换已成为内容生态系统中的关键环节。Markdown 作为轻量级标记语言，以其语法简洁、易读易写的特性在内容创作领域占据重要地位；而 HTML 作为网页标准格式，是内容展示与交互的基础。

本文将分享如何利用国产文档处理库 Spire.Doc for Python 实现 Markdown 与 HTML 两种格式之间的相互互转，代码简洁、适合文档系统、博客平台、内容管理工具等场景。

与同类工具的优势对比

相比 pandoc 等通用转换工具，Spire.Doc for Python 具有以下优势：

• 无需安装Microsoft Word或其他办公软件即可运行
• 对复杂格式的处理更精准，尤其是表格和图片
• 转换速度快，适合批量处理文档
• 完美支持Windows、Linux和 macOS 系统

pip 安装命令：

pip install Spire.Doc

（点击申请免费测试授权）

Python 将 Markdown 转换为 HTML

将 Markdown 文档转为 HTML，可用于网页发布、在线文档预览等场景。以下是完整 Python 代码，包含详细注释：

from spire.doc import *

# 加载Markdown文档
doc = Document()
doc.LoadFromFile("示例.md", FileFormat.Markdown)

# 将Markdown另存为HTML
doc.SaveToFile("example.html", FileFormat.Html)

# 关闭文档
doc.Close()

代码简洁易懂：创建Document对象 → LoadFromFile 加载 Markdown → SaveToFile 保存为HTML → 关闭文档释放资源

Python 将 HTML 转换为 Markdown

将 HTML 文件转为 Markdown，可用于网页内容存档、文档二次编辑等场景。实现逻辑与 Markdown 转 HTML 对称，仅需调整文件格式参数。

from spire.doc import *

# 加载HTML文件
doc = Document()
doc.LoadFromFile("input.html", FileFormat.Html)

# 将HTML另存为Markdown
doc.SaveToFile("output.md", FileFormat.Markdown)

# 关闭文档
doc.Close()

关键细节

1. HTML 标签兼容性：Spire.Doc 支持大多数标准 HTML 标签的转换（如 <h1>、<p>、<a>、<img>、<code>），但对于复杂的 CSS样式，转换后可能简化为基础 Markdown 语法。
2. 图片与链接：若 HTML 中包含本地图片，转换为 Markdown 后链接路径会保持不变，需确保目标 Markdown 文件与图片路径的相对位置正确。

批量转换与自动化处理

若需处理文件夹中的所有 Markdown 或 HTML 文件，可结合 os 库遍历文件：

import os
from spire.doc import *

def batch_convert_files(input_dir, output_dir, source_format, target_format):
    """
    批量转换目录中的文件
    
    参数:
        input_dir (str): 输入文件目录
        output_dir (str): 输出文件目录
        source_format: 源文件格式 (FileFormat.Markdown 或 FileFormat.Html)
        target_format: 目标文件格式 (FileFormat.Html 或 FileFormat.Markdown)
    """
    # 创建输出目录（如果不存在）
    if not os.path.exists(output_dir):
        os.makedirs(output_dir)
        print(f"创建输出目录: {output_dir}")
    
    # 获取源文件扩展名
    source_ext = ".md" if source_format == FileFormat.Markdown else ".html"
    
    # 遍历输入目录
    for filename in os.listdir(input_dir):
        # 只处理指定格式的文件
        if not filename.endswith(source_ext):
            continue
            
        # 构建完整路径
        input_path = os.path.join(input_dir, filename)
        base_name = os.path.splitext(filename)[0]
        target_ext = ".html" if target_format == FileFormat.Html else ".md"
        output_path = os.path.join(output_dir, base_name + target_ext)
        
        try:
            # 执行转换
            doc = Document()
            doc.LoadFromFile(input_path, source_format)
            doc.SaveToFile(output_path, target_format)
            doc.Close()
            print(f"已转换: {filename} -> {base_name}{target_ext}")
            
        except Exception as e:
            print(f"转换 {filename} 失败: {str(e)}")

# 示例：批量将Markdown转换为HTML
batch_convert_files(
    input_dir="markdown_files",
    output_dir="html_output",
    source_format=FileFormat.Markdown,
    target_format=FileFormat.Html
)

# 示例：批量将HTML转换为Markdown
# batch_convert_files(
#     input_dir="html_files",
#     output_dir="markdown_output",
#     source_format=FileFormat.Html,
#     target_format=FileFormat.Markdown
# )

掌握 Spire.Doc for Python 的文档转换能力，将极大提升你的内容处理效率，该库不仅支持Markdown与HTML互转，还支持转Word、PDF等多种格式，具体可查看其中文教程合集。