Word Output (DOCX)

leafpress uses python-docx to generate .docx files directly from rendered HTML.

DOCX options

Configure DOCX output in leafpress.yml under the docx: key:

docx:
  template_path: null   # optional path to a .docx template

Field	Default	Description
`template_path`	`null`	Path to a `.docx` file used as a style template

You can provide a .docx template to inherit paragraph styles, fonts, and page setup from an existing Word document:

docx:
  template_path: "./my-template.docx"

The template path is relative to the leafpress.yml file.

Cover page and table of contents are supported in DOCX output, controlled by the same flags as PDF:

leafpress convert . -f docx --no-cover-page --no-toc

leafpress converts the following Markdown/HTML elements to DOCX:

Element	DOCX equivalent
`h1`–`h6`	Heading 1–6 styles
`p`	Normal paragraph
`strong`, `b`	Bold run
`em`, `i`	Italic run
`code` (inline)	Monospace run
`pre code`	Code Block style
`ul` / `ol`	List Bullet / List Number styles
`li`	List item
`table`	Word table
`th` / `td`	Table cell
`a`	Hyperlink
`img`	Inline image (local files)
`br`	Line break
`hr`	Paragraph separator
`del`, `s`	Strikethrough run
`sub`	Subscript run
`sup`	Superscript run
`kbd`	Monospace run
Emoji images	Unicode emoji character (from `alt` attribute)
Admonition blocks	Styled paragraph with title

Remote images (except those already fetched by the renderer) are skipped in DOCX output
Complex CSS styling (custom colors, gradients) is not preserved in DOCX
Mermaid diagrams are rendered as SVG in PDF but may appear as placeholder text in DOCX