Alternativa a python-docx sin plantillas

​

El problema en la práctica

• Cada título, lista y tabla es código: añadir una sección nueva es tocar el programa.
• Las plantillas .docx hay que diseñarlas, versionarlas y mantener sus marcadores al día.
• Si el formato se aplica párrafo a párrafo, el documento se ve bien pero cuesta editarlo después en Word.
• Tablas que se salen de la página o títulos que quedan solos al final de una hoja solo se ven al abrir el archivo.

​

La solución con Doconda

from pathlib import Path
from doconda import Doconda

doconda = Doconda()  # lee la key de DOCONDA_API_KEY
doc = doconda.documents.create(
    format="docx",
    content={"markdown": "# Nota interna\n\nLa reunión del lunes pasa a las 10:00."},
    style="letra Lora, títulos azules, con números de página",
)
Path("nota.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: "# Nota interna\n\nLa reunión del lunes pasa a las 10:00." },
  style: "letra Lora, títulos azules, con números de página",
})
await writeFile("nota.docx", await doconda.documents.download(doc.id, "docx"))

​

Qué recibes

• El .docx y su PDF (doconda.documents.download(doc["id"], "pdf")).
• status: ready, ready_with_warnings, needs_review o failed (no se cobra).
• style_unsupported: lo que pediste en style y no se pudo aplicar. Nunca se ignora en silencio.
• Un informe (documents.report(id)) con lo que conviene mirar.

​

Preguntas frecuentes

​

Sigue leyendo

• Crear: todas las opciones de creación.
• Revisar: arregla un Word que ya tienes.
• SDK de Python y SDK de TypeScript.
• Ejemplos en GitHub.