Docx Creation

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

doc = Document()

# Set core properties
doc.core_properties.title = "Document Title"
doc.core_properties.author = "Author Name"

Step 2 — Add content with proper hierarchy

# Title
title = doc.add_heading("Quarterly Business Report", level=0)
title.alignment = WD_ALIGN_PARAGRAPH.CENTER

# Section heading
doc.add_heading("Executive Summary", level=1)

# Paragraph with formatting
para = doc.add_paragraph()
run = para.add_run("Key findings: ")
run.bold = True
run.font.size = Pt(12)
run.font.color.rgb = RGBColor(0x33, 0x33, 0x33)
para.add_run("Revenue increased 15% quarter-over-quarter.")

# Bullet list
doc.add_paragraph("First key point", style="List Bullet")
doc.add_paragraph("Second key point", style="List Bullet")
doc.add_paragraph("Third key point", style="List Bullet")

# Numbered list
doc.add_paragraph("Step one", style="List Number")
doc.add_paragraph("Step two", style="List Number")

Step 3 — Add tables

# Create table with header row
table = doc.add_table(rows=1, cols=3)
table.style = "Light Grid Accent 1"
table.alignment = WD_TABLE_ALIGNMENT.CENTER

# Header row
header_cells = table.rows[0].cells
header_cells[0].text = "Metric"
header_cells[1].text = "Q3 2025"
header_cells[2].text = "Q4 2025"

# Data rows
data = [
    ("Revenue", "$1.2M", "$1.38M"),
    ("Users", "45,000", "52,000"),
    ("Churn", "3.2%", "2.8%"),
]
for metric, q3, q4 in data:
    row = table.add_row().cells
    row[0].text = metric
    row[1].text = q3
    row[2].text = q4

# Style header row bold
for cell in table.rows[0].cells:
    for paragraph in cell.paragraphs:
        for run in paragraph.runs:
            run.bold = True

Step 4 — Add images and page breaks

# Add image (if available)
# doc.add_picture("chart.png", width=Inches(5.5))

# Page break before new section
doc.add_page_break()
doc.add_heading("Detailed Analysis", level=1)

Step 5 — Set page layout and save

# Page margins
for section in doc.sections:
    section.top_margin = Cm(2.54)
    section.bottom_margin = Cm(2.54)
    section.left_margin = Cm(2.54)
    section.right_margin = Cm(2.54)

# Save
doc.save("report.docx")

Common Pitfalls

Complete Example

"""Generate a formatted business report as .docx"""
from docx import Document
from docx.shared import Inches, Pt, Cm, RGBColor
from docx.enum.text import WD_ALIGN_PARAGRAPH
from docx.enum.table import WD_TABLE_ALIGNMENT

doc = Document()
doc.core_properties.title = "Q4 2025 Report"
doc.core_properties.author = "Analytics Team"

# Margins
for section in doc.sections:
    section.top_margin = Cm(2.54)
    section.bottom_margin = Cm(2.54)
    section.left_margin = Cm(2.54)
    section.right_margin = Cm(2.54)

# Title
title = doc.add_heading("Q4 2025 Business Report", level=0)
title.alignment = WD_ALIGN_PARAGRAPH.CENTER

# Summary
doc.add_heading("Executive Summary", level=1)
p = doc.add_paragraph()
p.add_run("Highlights: ").bold = True
p.add_run("Strong quarter with 15% revenue growth and reduced churn.")

# Key metrics table
doc.add_heading("Key Metrics", level=1)
table = doc.add_table(rows=1, cols=3)
table.style = "Light Grid Accent 1"

headers = ["Metric", "Q3 2025", "Q4 2025"]
for i, h in enumerate(headers):
    table.rows[0].cells[i].text = h
    for run in table.rows[0].cells[i].paragraphs[0].runs:
        run.bold = True

for metric, q3, q4 in [("Revenue", "$1.2M", "$1.38M"), ("Users", "45K", "52K")]:
    row = table.add_row().cells
    row[0].text = metric
    row[1].text = q3
    row[2].text = q4

# Next steps
doc.add_heading("Next Steps", level=1)
for item in ["Expand to European markets", "Launch premium tier", "Hire 5 engineers"]:
    doc.add_paragraph(item, style="List Bullet")

doc.save("q4_report.docx")
print("Saved q4_report.docx")

Tips

• Use built-in styles like "Light Grid Accent 1" for tables — they're professional and consistent
• For headers/footers, access section.header and section.footer objects
• To create a template-based doc, use Document("template.docx") to open an existing file
• Keep font choices minimal: one heading font, one body font