docx-press

DOCX Press — Professional Document Authoring

Overview

This skill teaches how to produce Markdown that renders cleanly into DOCX via write_docx. The renderer is python-docx based — it parses your Markdown into native Word elements (paragraphs, headings, tables, code blocks, blockquotes, images, hyperlinks, and citations). You write standard Markdown — the renderer handles all styling with a fixed professional palette.

Renderer Contract

This skill is authoring guidance for the DOCX renderer. The canonical callable contract lives on the rendering_tools.write_docx tool definition; do not treat this skill as a parameter reference.

Important: DOCX rendering is Markdown-only. Unlike PDF rendering, which can use HTML or Mermaid when appropriate, the DOCX renderer expects standard Markdown primitives: headings, lists, tables, code fences, blockquotes, images, links, and citation tokens.

---

Core Rules

1. Use headings (# through ######) to structure sections with proper hierarchy
2. Prefer short paragraphs and concise lists
3. Use pipe tables with a header row; keep column counts modest (3–5)
4. Images use ![alt text](path/to/image.png) — local files only
5. Use > text for blockquotes (rendered as shaded boxes with left accent)
6. Use triple backticks for code blocks (rendered in styled boxes)
7. URLs are auto-linked: just write https://example.com
8. Markdown links for custom text: [click here](https://example.com)
9. Avoid HTML tags — keep to Markdown primitives; HTML is not processed

---

How the Renderer Structures Your Document

Understanding the renderer's logic prevents common mistakes:

1. First # Heading → becomes the document title (large, bold, with horizontal rule beneath)
2. Each ## Heading → creates a major document section (H1 styled). The renderer splits the document by ## boundaries.
3. ### through ###### → rendered as progressively smaller, indented headings within their parent section
4. Everything else (paragraphs, lists, tables, etc.) → rendered as body content within the current section