docx-generator

name	docx-generator
description	Generate professional Word documents with structured content, tables, headers, styles, and formatting. Uses python-docx. Use when creating reports, proposals, contracts, specs, or any structured document as DOCX/Word format.
version	1.0.0
category	documents

Word Document Generator

Generate professional DOCX files using python-docx.

Rules (Mandatory)

1. Document structure — title page, table of contents placeholder, numbered headings, page breaks between major sections
2. No raw text dumps — use proper heading levels (Heading 1-4), styled paragraphs, and lists
3. Tables for structured data — never present tabular data as plain text
4. Consistent styling — fonts, colors, spacing uniform. Use document styles, not inline formatting
5. Headers/footers — include document title in header, page numbers in footer
6. File output — save to concrete path, verify file exists

Document Sections Pattern

Section	Style	Purpose
Title Page	Custom	Title, subtitle, author, date, version
ToC Placeholder	Heading	"Table of Contents" (Word auto-generates on open)
Executive Summary	Heading 1 + Normal	1-paragraph overview
Body Sections	Heading 1-3 + Normal	Main content with sub-sections
Tables/Figures	Table style + Caption	Data presentation
Appendix	Heading 1 + Normal	Supporting material

python-docx Patterns

from docx import Document
from docx.shared import Inches, Pt, RGBColor, Cm
from docx.enum.text import WD_ALIGN_PARAGRAPH
from docx.enum.table import WD_TABLE_ALIGNMENT

doc = Document()

# Set default font
style = doc.styles['Normal']
font = style.font
font.name = 'Calibri'
font.size = Pt(11)

# Title
doc.add_heading('Document Title', level=0)
doc.add_paragraph('Author: <your-name> | Date: 2026-03-23')
doc.add_page_break()

# Sections
doc.add_heading('1. Executive Summary', level=1)
doc.add_paragraph('Overview text here.')

doc.add_heading('2. Analysis', level=1)
doc.add_heading('2.1 Market Data', level=2)

# Table
table = doc.add_table(rows=3, cols=3, style='Light Grid Accent 1')
table.rows[0].cells[0].text = 'Metric'
table.rows[0].cells[1].text = 'Q3'
table.rows[0].cells[2].text = 'Q4'

# Bullet list
for item in ['Point one', 'Point two', 'Point three']:
    doc.add_paragraph(item, style='List Bullet')

# Header/Footer
section = doc.sections[0]
header = section.header
header.paragraphs[].text = 
footer = section.footer
footer.paragraphs[].text =   

doc.save()

Workflow

1. Outline — define heading structure (H1/H2/H3)
2. Styles — set fonts, colors, spacing
3. Content — add paragraphs, lists, tables
4. Formatting — headers, footers, page breaks
5. Save — write to file, verify

Install

pip install python-docx