# Markdown to Word (.docx)

Convert Markdown into a real Microsoft Word .docx document in your browser. Headings, lists, quotes, code blocks and inline formatting become editable Word content.

## Run it

- **CLI:** `gizza tool markdown-to-docx "# Project brief

This is **ready** for review.

- Scope
- Timeline

> Keep a copy for stakeholders."`
- **Web:** https://gizza.ai/tools/markdown-to-docx/
- **Agents:** machine-readable descriptor (parameters JSON Schema) at https://gizza.ai/tools/markdown-to-docx/tool.json

## Inputs

- `markdown` — Markdown _(field)_
- `title` — Document title (optional) _(field)_
- `page_size` — Page size _(field)_
- `font_family` — Body font _(field)_
- `font_size` — Body font size _(field)_
- `page_break` — Treat --- as a page break _(field)_

## Output

- Word document (text)

## Query parameters

Open the tool pre-filled and auto-run via URL:

- `markdown` — Markdown
- `title` — Document title (optional)
- `page_size` — Page size
- `font_family` — Body font
- `font_size` — Body font size
- `page_break` — Treat --- as a page break

Example: `https://gizza.ai/tools/markdown-to-docx/?markdown=%23%20Project%20brief%0A%0AThis%20is%20%2A%2Aready%2A%2A%20for%20review.%0A%0A-%20Scope%0A-%20Timeline%0A%0A%3E%20Keep%20a%20copy%20for%20stakeholders.&title=Project%20Brief&page_size=letter&font_family=calibri&font_size=11&page_break=true`

---

## Convert Markdown into an editable Word document

Paste Markdown and download a genuine Office Open XML `.docx` file — the same ZIP-based format Word,
Google Docs, Pages and LibreOffice Writer open natively. Headings become Word heading styles, bullets
and numbered items become native lists, block quotes get quote styling, fenced code blocks use a
monospace shaded paragraph, and inline **bold**, *italic*, `` `code` `` and `~~strikethrough~~` are
preserved as separate Word runs.

Choose **Letter** or **A4**, select a body font, set the base font size, and decide whether a thematic
break (`---`) should draw a horizontal rule or start a new page. Everything runs in your browser with
WebAssembly, so the Markdown never needs to be uploaded.

### Worked example

Input:

```markdown
# Project brief

This is **ready** for review.

- Scope
- Timeline

> Keep a copy for stakeholders.
```

Output: a `document.docx` with a Heading 1 paragraph, formatted bold text, two list items and a styled
quote paragraph. Add a **Document title** to prepend a title paragraph and store the title in the DOCX
metadata, or enable **Treat --- as a page break** for report-style section breaks.

## Limits and edge cases

This is an offline structural converter, not a full browser or Word clone. Remote images are rendered
as their alt text because the block does not fetch external files. LaTeX math, Mermaid diagrams,
syntax-colored code highlighting and generated tables of contents are intentionally out of scope. Very
large documents are limited by browser memory and the chat surface's 24 MB output cap.

## FAQ

<details>
<summary>Is the download a real .docx file?</summary>

Yes. The tool writes an Office Open XML package with `[Content_Types].xml`, relationships, document,
styles, numbering and document property parts. It is not Markdown renamed with a `.docx` extension.

</details>

<details>
<summary>Which Markdown features are preserved?</summary>

Headings, paragraphs, bold, italic, inline code, strikethrough, bullets, numbered lists, nested list
indentation, block quotes, fenced code blocks and thematic breaks are converted into editable Word
structure. Links keep their visible label text; remote image syntax keeps the alt text.

</details>

<details>
<summary>Can I control the Word page setup?</summary>

Yes. Choose Letter or A4 page size, Calibri, Aptos, Times New Roman or Arial as the body font, and an
8–24 point base font size. Headings scale relative to that base size.

</details>

<details>
<summary>Does my Markdown leave the browser?</summary>

No. The page version runs the converter in WebAssembly and creates a local `data:` URL for the download.
No upload service is contacted.

</details>

## Related tools

- [BibTeX Formatter & Validator](https://gizza.ai/tools/bibtex-format/): Free BibTeX formatter and validator — pretty-print, sort and align .bib bibliography entries in your browser. Consistent indentation, no sign-up, no upload.
- [Citation Generator](https://gizza.ai/tools/citation-generator/): Free APA 7, MLA 9, Chicago and Harvard citation generator — format author, title, year, journal and URL into a correct reference right in your browser.
- [Document Splitter](https://gizza.ai/tools/document-splitter/): Split a long Markdown or HTML document into separate files, one per top-level heading. Runs entirely in your browser, no upload, no sign-up.
- [HTML to Markdown](https://gizza.ai/tools/html-to-markdown/): Convert HTML into clean Markdown instantly in your browser — preserves headings, links, lists, code blocks, tables, and emphasis. Free, private, no upload, no sign-up.
- [CSV to LaTeX table](https://gizza.ai/tools/latex-table/): Convert CSV or TSV data into a LaTeX tabular environment (booktabs, grid, or plain), in your browser. Free, private, no upload.