> ## 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 aplicar el estilo de tu marca a documentos generados?

> Describe fuente y colores de tu marca en style, o pasa un archivo tuyo en sources para copiar su diseño: fuentes, colores, logo y portada.

Para aplicar el estilo de tu marca, describe su fuente y sus colores en `style` («letra Montserrat, títulos #1F3A5F,
acento #E4572E»), o pasa en `sources` un archivo con tu diseño y pide «con el diseño de nuestra plantilla». Con un
archivo, Doconda copia sus fuentes, colores, márgenes, cabecera y pie, logo y portada.

## Pasos

1. Guarda tu API key en `DOCONDA_API_KEY` e instala el SDK (`pip install doconda` o `npm install @doconda/sdk`).
2. Sube un archivo con tu diseño (un Word, una presentación, un Excel, un PDF o una imagen).
3. Crea el documento con `quality: "standard"` y di en la petición que use ese diseño.

<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
  template = doconda.files.upload("plantilla-marca.docx")
  doc = doconda.documents.create(
      format="docx",
      prompt="Propuesta comercial para un cliente de logística, con el diseño de nuestra plantilla",
      sources=[template["id"]],
      quality="standard",
  )
  Path("propuesta.docx").write_bytes(doconda.documents.download(doc["id"], "docx"))
  ```

  ```ts TypeScript theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  import { readFile, writeFile } from "node:fs/promises"
  import { Doconda } from "@doconda/sdk"

  const doconda = new Doconda()
  const template = await doconda.files.upload(await readFile("plantilla-marca.docx"), "plantilla-marca.docx")
  const doc = await doconda.documents.create({
    format: "docx",
    prompt: "Propuesta comercial para un cliente de logística, con el diseño de nuestra plantilla",
    sources: [template.id],
    quality: "standard",
  })
  await writeFile("propuesta.docx", await doconda.documents.download(doc.id, "docx"))
  ```
</CodeGroup>

Sin plantilla, basta con el texto: `style: "letra Montserrat, títulos #1F3A5F, acento #E4572E, en el pie: Mi
Empresa S.L."`. Esto funciona en todos los niveles, también en `fast`.

## Qué puedes pedir en `style`

* **Fuente**: cualquier familia de Google Fonts, y además Calibri, Cambria, Arial, Times New Roman y Courier New.
* **Colores** del título, los títulos, el texto o el acento, por nombre o en hexadecimal.
* **Alineación**, tamaño, interlineado, márgenes y orientación.
* **Portada, índice, números de página, cabecera y pie.**

## Qué devuelve

* Un archivo editable: el aspecto va en los estilos del documento (`Normal`, `Título 1`…), y su PDF con la fuente
  incrustada.
* `style_applied`: cómo se entendió el estilo, y `style_unsupported`: lo que no se pudo aplicar.
* El evento `design.chosen` dice qué archivo se usó como diseño.

## Límites

* Copiar el diseño de un archivo necesita `standard` o `best`. En `fast` el documento sale con un diseño propio y el
  informe lo avisa (`design.not_copied`).
* El Word usa la fuente por su nombre: si quien lo abre no la tiene instalada, Word pondrá una parecida. El PDF la
  lleva incrustada.

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Sirve para PowerPoint?">
    Sí. Una presentación que pases en `sources` se usa como plantilla: el resultado parte de sus diapositivas.
  </Accordion>

  <Accordion title="¿Puedo pasar también material para el contenido?">
    Sí. El archivo de diseño es el que nombras en la petición; el resto de `sources` sigue siendo material.
  </Accordion>

  <Accordion title="¿Qué pasa si pido algo que no se puede hacer?">
    No se ignora en silencio: vuelve en `style_unsupported` (por ejemplo, «fondo con degradado») y el resto se aplica.
  </Accordion>
</AccordionGroup>

## Sigue leyendo

* [Estilo](/guides/style) y [Copiar el diseño de un archivo](/guides/create#copiar-el-diseño-de-un-archivo).
* [Quickstart](/quickstart).


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