Download a saved document as Word

The download menu on a saved document now offers a .docx, built on the spot from the same HTML the preview already renders. No headless browser involved — it needs a save first, since the conversion runs on the account's copy.

A saved document can be downloaded as a .docx, built from the same HTML the preview already shows. Word, Pages, LibreOffice and Google Docs all open it as an ordinary document — headings are Word headings, tables are Word tables, lists nest, and code keeps its monospace.

What survives the trip

Headings one to six, paragraphs, bold and italic, ordered and unordered lists with their nesting, tables with their header row, block quotes, horizontal rules, links with their text and their address, and fenced code. What does not: anything that only exists in a browser — a live embed, a collapsible section, a mermaid diagram that was never rendered to an image.

Remote images are deliberately left out. A converter that fetches every picture a document mentions is a converter that makes a request to any address the document's author chose, and the trade — a picture, for a server that follows strangers' links — is not worth making.

Why it needs a save first

The conversion runs on the account's copy of the document, which is what the download endpoint reads. Converting a file you have only just dropped is the browser's job and does not involve the account at all; .docx is the one direction that does.

The other direction

Dropping a .docx on the converter reads it back into Markdown — headings, tables, lists and all — which is the round trip most people actually want: a Word document out of a colleague's mailbox, into Markdown, into a repository.

From a script

GET /api/v1/documents/:id.docx with an API key returns the same file, for a build that publishes documentation as Word for people who want it that way.

Related: Markdown to Word, in full, and reading a .docx back into Markdown.