如何用Python替换docx文档中的{{ table }}标签为指定表格？

要在文档中间替换标签为表格，不能直接依赖默认在末尾添加的add_table()方法，需要定位标签所在段落，拆分文本后插入表格，具体实现如下：

核心思路 #

1. 遍历文档段落，定位包含{{ table }}的段落
2. 拆分段落文本，保留标签前后的内容
3. 在标签位置插入表格，调整表格在文档中的位置
4. 清理原标签内容，保证文档格式一致

代码实现 #

from docx import Document

# 加载目标文档
doc = Document("input.docx")

# 遍历所有段落，查找目标标签
for para in doc.paragraphs:
    if "{{ table }}" not in para.text:
        continue
    
    # 记录当前段落的索引，用于定位表格插入位置
    para_idx = doc.paragraphs.index(para)
    # 拆分标签前后的文本内容
    text_parts = para.text.split("{{ table }}")
    
    # 更新原段落为标签前的文本
    para.text = text_parts[0]
    
    # 处理标签后的文本：如果有内容，新建段落并继承原格式
    if len(text_parts) > 1 and text_parts[1].strip():
        new_para = doc.add_paragraph(text_parts[1])
        new_para.style = para.style
        # 复制字体格式（按需调整）
        new_para.font.name = para.font.name
        new_para.font.size = para.font.size
    
    # 创建2行2列的表格，使用默认网格样式
    table = doc.add_table(rows=2, cols=2, style="Table Grid")
    # 将表格插入到原段落的下一个位置
    doc._body.insert(para_idx + 1, table._element)
    
    # 如果原段落清空后为空，删除空段落
    if not para.text.strip():
        para._element.getparent().remove(para._element)

# 保存修改后的文档
doc.save("output.docx")

关键说明 #

• 表格样式Table Grid是docx自带的普通带边框表格，可根据需求替换为其他内置样式（如Table Normal）
• 代码中复制了段落的样式和字体格式，确保新段落与原文档格式一致
• 如果标签所在段落仅包含{{ table }}，代码会自动删除空段落，避免多余换行

内容的提问来源于stack exchange，提问作者Pomelopl