> ## 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 generar un informe con portada e índice por API?

> Pide «con portada, índice y números de página» en style: Doconda los añade al Word y a su PDF, en un archivo editable.

Para generar un informe con portada e índice, pide «con portada, índice y números de página» en `style` (o en la
misma frase del `prompt`) con `format: "docx"`. Doconda los añade al Word y a su PDF; la portada y el índice entran en
el estilo básico, así que funcionan también en `quality: "fast"`.

## Pasos

1. Guarda tu API key en `DOCONDA_API_KEY` e instala el SDK (`pip install doconda` o `npm install @doconda/sdk`).
2. Pasa tu contenido en Markdown (o una frase en `prompt`) y el estilo.
3. Descarga el Word y comprueba en `style_applied` que se entendió.

<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": "# Informe anual\n\n## Resumen\n\n…\n\n## Ventas\n\n…\n\n## Próximos pasos\n\n…"},
      style="con portada, índice y números de página; títulos azul oscuro; en el pie: Confidencial",
  )
  print(doc["style_applied"])
  Path("informe.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: "# Informe anual\n\n## Resumen\n\n…\n\n## Ventas\n\n…\n\n## Próximos pasos\n\n…" },
    style: "con portada, índice y números de página; títulos azul oscuro; en el pie: Confidencial",
  })
  console.log(doc.style_applied)
  await writeFile("informe.docx", await doconda.documents.download(doc.id, "docx"))
  ```
</CodeGroup>

## Qué devuelve

* Un Word editable con portada, índice y números de página, y su PDF.
* `style_applied`: cómo se entendió el estilo (incluye `cover_page`, `table_of_contents`, `page_numbers`, `header` y
  `footer`).
* `style_unsupported`: lo que pediste y no se pudo aplicar. El resto se aplica igual.
* El estilo va en los estilos de Word (`Normal`, `Título 1`…), así lo que añadas después sigue el mismo diseño.

## Límites

* En `quality: "fast"` el estilo es el básico: fuente, tamaño, colores, alineación, márgenes, portada, índice,
  cabecera y pie. Gráficos o un diseño copiado de tu plantilla necesitan `standard` o `best`.
* La cabecera y el pie son texto («en el pie: Confidencial»).

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Puede escribir el informe por mí?">
    Sí: usa `prompt` en vez de `content` («Informe de la ley de vivienda con portada e índice»). El estilo de la frase
    también se aplica.
  </Accordion>

  <Accordion title="¿Puedo poner gráficos?">
    Sí, en `standard` y `best`. Ver [niveles de calidad](/guides/create#niveles-de-calidad).
  </Accordion>

  <Accordion title="¿Puedo apaisarlo o cambiar los márgenes?">
    Sí: «apaisado», «márgenes de 2 cm». Ver [Estilo](/guides/style).
  </Accordion>
</AccordionGroup>

## Sigue leyendo

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


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