파이썬 업무 자동화#10워드(Word) 문서 자동 생성! 엑셀 명단으로 계약서·안내문 100장 뽑기 (python-docx) 📄

pip install python-docx openpyxl python-dotenv

from docx import Document
from docx.shared import Pt, Cm
from docx.enum.text import WD_ALIGN_PARAGRAPH

doc = Document()                      # 빈 문서 생성

title = doc.add_heading("교육 수료 안내문", level=1)
title.alignment = WD_ALIGN_PARAGRAPH.CENTER

p = doc.add_paragraph()
run = p.add_run("김철수 님, 수고하셨습니다.")
run.bold = True
run.font.size = Pt(12)

doc.add_paragraph("위 사람은 2026년 사내 교육 과정을 성실히 이수하였음을 증명합니다.")

doc.save("sample.docx")
print("저장 완료!")

from docx.oxml.ns import qn

def set_korean_font(doc, font_name="맑은 고딕", size=11):
    """문서 기본 스타일에 한글 폰트를 적용해요."""
    style = doc.styles["Normal"]
    style.font.name = font_name
    style.font.size = Pt(size)
    # 한글(동아시아 문자) 폰트는 XML 속성을 직접 지정해야 적용돼요
    style.element.rPr.rFonts.set(qn("w:eastAsia"), font_name)

def replace_text(doc, mapping):
    """문서 전체(본문 문단 + 표 셀)에서 자리표시자를 치환해요."""
    def _replace_in_paragraph(para):
        # run이 쪼개져 있으면 치환이 안 되므로 문단 텍스트를 통째로 확인
        full_text = para.text
        if not any(key in full_text for key in mapping):
            return
        for key, value in mapping.items():
            full_text = full_text.replace(key, str(value))
        # 첫 run에 몰아넣고 나머지는 비움 (서식은 첫 run 것을 유지)
        for i, run in enumerate(para.runs):
            run.text = full_text if i == 0 else ""

    for para in doc.paragraphs:
        _replace_in_paragraph(para)

    for table in doc.tables:
        for row in table.rows:
            for cell in row.cells:
                for para in cell.paragraphs:
                    _replace_in_paragraph(para)

from openpyxl import load_workbook

def read_rows(xlsx_path):
    wb = load_workbook(xlsx_path, data_only=True)   # 수식이 아닌 '값'을 읽어요
    ws = wb.active
    headers = [c.value for c in ws[1]]              # 1행을 헤더로 사용
    rows = []
    for row in ws.iter_rows(min_row=2, values_only=True):
        if not row[0]:                              # 빈 줄 만나면 중단
            break
        rows.append(dict(zip(headers, row)))
    wb.close()
    return rows

# make_docs.py
# python-docx 1.2.0 / openpyxl 3.1.x / Python 3.10+

import os
import re
from pathlib import Path

from dotenv import load_dotenv
from docx import Document
from openpyxl import load_workbook

load_dotenv()

# 경로·설정값은 코드에 박지 말고 .env에서 불러와요
TEMPLATE_PATH = os.getenv("TEMPLATE_PATH", "template.docx")
EXCEL_PATH = os.getenv("EXCEL_PATH", "명단.xlsx")
OUTPUT_DIR = os.getenv("OUTPUT_DIR", "output")
FILENAME_FORMAT = os.getenv("FILENAME_FORMAT", "{이름}_안내문.docx")

def read_rows(xlsx_path):
    """엑셀 1행을 헤더로 삼아 dict 리스트로 읽어와요."""
    wb = load_workbook(xlsx_path, data_only=True)
    ws = wb.active
    headers = [c.value for c in ws[1]]
    rows = []
    for row in ws.iter_rows(min_row=2, values_only=True):
        if not row[0]:
            break
        rows.append(dict(zip(headers, row)))
    wb.close()
    return rows

def replace_text(doc, mapping):
    """본문 문단 + 표 셀 + 머리글에서 자리표시자를 치환해요."""

    def _replace_in_paragraph(para):
        full_text = para.text
        if not any(key in full_text for key in mapping):
            return
        for key, value in mapping.items():
            full_text = full_text.replace(key, str(value))
        for i, run in enumerate(para.runs):
            run.text = full_text if i == 0 else ""

    def _walk(container):
        for para in container.paragraphs:
            _replace_in_paragraph(para)
        for table in container.tables:
            for row in table.rows:
                for cell in row.cells:
                    _walk(cell)

    _walk(doc)
    for section in doc.sections:
        _walk(section.header)
        _walk(section.footer)

def safe_filename(name):
    """윈도우에서 파일명에 못 쓰는 문자를 _ 로 바꿔요."""
    return re.sub(r'[\\/:*?"<>|]', "_", str(name)).strip()

def main():
    template = Path(TEMPLATE_PATH)
    if not template.exists():
        raise FileNotFoundError(f"양식 파일이 없어요: {template.resolve()}")

    out_dir = Path(OUTPUT_DIR)
    out_dir.mkdir(parents=True, exist_ok=True)

    rows = read_rows(EXCEL_PATH)
    print(f"명단 {len(rows)}건을 읽었어요.")

    for i, row in enumerate(rows, start=1):
        # {"이름": "김철수"} -> {"{{이름}}": "김철수"}
        mapping = {f"{{{{{k}}}}}": (v if v is not None else "") for k, v in row.items()}

        doc = Document(str(template))       # 매번 양식을 새로 열어야 값이 안 섞여요!
        replace_text(doc, mapping)

        filename = safe_filename(FILENAME_FORMAT.format(**row))
        doc.save(out_dir / filename)
        print(f"[{i}/{len(rows)}] {filename} 저장 완료")

    print(f"\n끝! '{out_dir.resolve()}' 폴더를 확인해보세요 🎉")

if __name__ == "__main__":
    main()

TEMPLATE_PATH=template.docx
EXCEL_PATH=명단.xlsx
OUTPUT_DIR=output
FILENAME_FORMAT={이름}_안내문.docx

my_docx_tool/
├── make_docs.py
├── .env
├── template.docx      ← {{이름}} {{부서}} {{수료일}} 이 들어있는 워드 양식
└── 명단.xlsx

python make_docs.py

명단 2건을 읽었어요.
[1/2] 김철수_안내문.docx 저장 완료
[2/2] 이영희_안내문.docx 저장 완료

끝! 'C:\...\my_docx_tool\output' 폴더를 확인해보세요 🎉

pip uninstall docx
pip install python-docx