A python-docx alternative without templates

​

The problem in practice

• Every heading, list and table is code: adding a new section means changing the program.
• .docx templates have to be designed, versioned and kept in sync with their placeholders.
• When formatting is applied paragraph by paragraph, the document looks right but is hard to edit later in Word.
• Tables that overflow the page or headings stranded at the bottom of a page only show up when you open the file.

​

The solution with Doconda

from pathlib import Path
from doconda import Doconda

doconda = Doconda()  # reads the key from DOCONDA_API_KEY
doc = doconda.documents.create(
    format="docx",
    content={"markdown": "# Internal note\n\nMonday's meeting moves to 10:00."},
    style="Lora font, blue headings, with page numbers",
)
Path("note.docx").write_bytes(doconda.documents.download(doc["id"], "docx"))

import { writeFile } from "node:fs/promises"
import { Doconda } from "@doconda/sdk"

const doconda = new Doconda()
const doc = await doconda.documents.create({
  format: "docx",
  content: { markdown: "# Internal note\n\nMonday's meeting moves to 10:00." },
  style: "Lora font, blue headings, with page numbers",
})
await writeFile("note.docx", await doconda.documents.download(doc.id, "docx"))

​

What you get back

• The .docx and its PDF (doconda.documents.download(doc["id"], "pdf")).
• status: ready, ready_with_warnings, needs_review or failed (not charged).
• style_unsupported: what you asked for in style that could not be applied. Never silently ignored.
• A report (documents.report(id)) with anything worth checking.

​

FAQ

​

Keep reading

• Create: every creation option.
• Review: fix a Word file you already have.
• Python SDK and TypeScript SDK.
• Examples on GitHub.