> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doconda.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ¿Cómo convertir Markdown a Word con estilos por API?

> Envía tu Markdown en content y el estilo en una frase a POST /documents con format docx: recibes un .docx editable y su PDF.

Para convertir Markdown a Word con estilos, envía tu texto en `content.markdown` y describe el aspecto en `style`
(«letra Lora, títulos azules, con números de página») con `format: "docx"`. Doconda maqueta el texto tal cual, aplica
el estilo a los estilos de Word (`Normal`, `Título 1`…) y devuelve el `.docx` editable y su PDF.

## Pasos

1. Crea una API key en el panel, en **API keys**, y guárdala en `DOCONDA_API_KEY`.
2. Instala el SDK: `pip install doconda` o `npm install @doconda/sdk`.
3. Llama a `documents.create` con tu Markdown y el estilo, y descarga el Word.

<CodeGroup>
  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  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"))
  ```

  ```ts TypeScript theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  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"))
  ```
</CodeGroup>

El Markdown admite títulos, párrafos, listas, tablas, negrita y cursiva, enlaces, saltos de página e imágenes
(`![Pie de foto](img:1)` para la primera imagen de `sources`).

## Qué devuelve

* Un `.docx` editable: el aspecto va en los estilos del documento, así lo que añadas después sigue el mismo diseño.
* Su PDF, con la fuente incrustada (`download(id, "pdf")`).
* `style_applied`: cómo se entendió el estilo (fuente, colores, alineación…), para comprobarlo.
* `style_unsupported`: lo que pediste y no se pudo aplicar. Nunca se ignora en silencio.
* `status`: `ready`, `ready_with_warnings`, `needs_review` o `failed` (no se cobra).

## Límites

* El texto se usa tal cual: Doconda no lo reescribe. Si quieres que lo redacte, usa `prompt` en vez de `content`.
* Con `quality: "fast"` el estilo es el básico: fuente, tamaño, colores, alineación, márgenes, portada, índice,
  cabecera y pie. Lo que no cabe ahí vuelve en `style_unsupported`.
* Copiar el diseño de un archivo tuyo necesita `standard` o `best`.

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Qué fuentes puedo usar?">
    Cualquier familia de Google Fonts y además Calibri, Cambria, Arial, Times New Roman y Courier New. Ver
    [Estilo](/guides/style).
  </Accordion>

  <Accordion title="¿Puedo usar la API sin SDK?">
    Sí. Es un `POST https://api.eu.doconda.com/v1/documents` con el mismo cuerpo. Ver el [Quickstart](/quickstart).
  </Accordion>

  <Accordion title="¿Es más barato que crear desde una frase?">
    Sí. Con tu Markdown Doconda solo maqueta, así que es más rápido y más barato. Ver
    [precios](/guides/account#precios).
  </Accordion>

  <Accordion title="¿Puedo sacar solo el PDF?">
    Sí, con `format: "pdf"`.
  </Accordion>
</AccordionGroup>

## Sigue leyendo

* [Crear](/guides/create) y [Estilo](/guides/style).
* [Quickstart](/quickstart).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.