docsmith 0.1.0

YAML-to-Word document generator for automated pipelines and LLM-driven content creation

docsmith

YAML-in, Word-out. Define document content in a simple YAML schema and docsmith forges it into a professionally formatted Word (.docx) file.

Why docsmith?

docsmith is built for automated pipelines and LLM-driven content generation. The YAML input format is deliberately simple -- flat, predictable, and easy for any language model or script to produce. No template engine, no programming required. Hand it a YAML file, get a Word document back.

Use cases:

• LLM document generation -- have an AI produce structured YAML, then render to Word
• CI/CD pipelines -- generate reports, proposals, or compliance documents as build artifacts
• Batch processing -- convert a directory of YAML files to Word in one pass
• Content-first authoring -- focus on content in YAML, let docsmith handle formatting

Installation

pipx install docsmith

Or with pip:

pip install docsmith

Usage

# Generate a Word document from a YAML source
docsmith input.yaml

# Specify output directory
docsmith input.yaml -o output/

Also works as a Python module:

python -m docsmith input.yaml

YAML Document Format

title: "Document Title"
subtitle: "Subtitle text"
status: "Draft"

content:
  - heading: "Section Heading"
    level: 1

  - text: "Paragraph with **bold** and *italic* support."

  - bullets:
      - "First bullet point"
      - "Second bullet with **bold**"

  - numbered:
      - "Step one"
      - "Step two"

  - table:
      headers: ["Column A", "Column B"]
      rows:
        - ["Cell 1", "Cell 2"]
        - ["Cell 3", "Cell 4"]

  - decision: "A decision callout that needs stakeholder input"

Supported Block Types

Block	Purpose
heading	Section heading (level 1-4)
text	Paragraph with inline bold/italic
bullets	Unordered list
numbered	Ordered list
table	Table with headers and rows
decision	Red decision callout

Document Metadata

docsmith sets SharePoint/OneDrive-compatible document properties:

• dc:creator and cp:lastModifiedBy set to "docsmith"
• dcterms:created and dcterms:modified set to generation timestamp
• dc:title and dc:subject populated from YAML metadata

Future Output Formats

Word is the first format. The YAML source schema is designed to be renderable to multiple output formats (PDF, HTML, Markdown) in future versions.

License

GPL-3.0-or-later. See LICENSE for details.