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

> ## Agent Instructions
> Conare's API is at https://api.conare.ai. Authenticate with `Authorization: Bearer $CONARE_API_KEY`.
> The full OpenAPI spec is at https://api.conare.ai/openapi.yaml; each endpoint has a page under /api-reference, and appending .md to any page URL returns its Markdown.
> Embed with model conare-embed-1; send input_type "query" for search queries. Rerank with conare-rerank-1.
> Prefer the TypeScript SDK (`npm install conare`) or plain HTTP in examples.
> Install the Conare skill with `npx skills add https://docs.conare.ai`; search these docs over MCP at https://docs.conare.ai/mcp; the whole site is at https://docs.conare.ai/llms-full.txt.

# Tipos de archivo y Markdown

> Los formatos de archivo que Conare lee, cómo cada uno se convierte en Markdown y cómo se leen las imágenes y el diseño.

Esto se aplica a ambas [rutas de archivos](https://docs.conare.ai/es/files.md): las subidas y `POST /parse`.

## Tipos de archivo

| Archivo | Extensiones | `type` |
| - | - | - |
| PDF | `.pdf` | `pdf` |
| Word | `.docx`, `.docm`, `.dotx`, `.doc` (97-2003), `.rtf`, `.odt` | `docx`, `doc`, `rtf`, `odt` |
| PowerPoint | `.pptx`, `.pptm`, `.potx`, `.ppsx`, `.ppt` (97-2003), `.odp` | `pptx`, `ppt`, `odp` |
| Excel | `.xlsx`, `.xlsm`, `.xls` (97-2003 y 5.0/95), `.ods`; las macros nunca se ejecutan | `xlsx`, `ods` (`xls`, `xlsm` también funcionan) |
| CSV, TSV | `.csv`, `.tsv` | `csv`, `tsv` |
| Texto, Markdown | `.txt`, `.md` | `txt`, `md` |
| Imágenes | `.png`, `.jpg`, `.webp`, `.tif` (todas las páginas), `.gif` (primer fotograma), `.bmp`, `.heic`, `.heif` | `png`, `jpeg`, `webp`, `tiff`, `gif`, `bmp`, `heic` (`jpg`, `tif`, `heif` también funcionan) |

| Cómo se lee | |
| - | - |
| Páginas de PDF | Cada página con contenido se lee mediante OCR, también las nativas digitales, así que se conservan las tablas, los encabezados y el orden de lectura |
| Una página que el OCR omite | Conserva su propia capa de texto |
| `.doc`, `.rtf`, `.odt` | Se leen como Word (`docx`); `.ppt`, `.odp` como PowerPoint (`pptx`); `.xls`, `.ods` como Excel (`xlsx`) |
| Tablas de `.ppt` | Se leen como el texto de sus celdas, una por línea |
| Gráficos | Su título, los títulos de los ejes y una tabla con sus valores |

Se rechazan con `415 unsupported_file`:

| Archivo | Guárdalo como |
| - | - |
| Word 6.0/95 | `.docx` |
| Imágenes AVIF | JPEG o PNG |

## Markdown

| Elemento | Se escribe como |
| - | - |
| Página, diapositiva, hoja | Empieza por `<!-- page 3 -->`, `<!-- slide 4 -->` o `<!-- sheet "Q3" -->` |
| Encabezados, listas | `#` y `##`; `-` y `1.` |
| Tablas | Markdown con una fila de encabezado; una `<table>` HTML con `colspan` y `rowspan` cuando hay celdas combinadas o supera 30 columnas o 300 filas |
| Números | Exactamente como se imprimen |
| Encabezado y pie de página recurrentes | `<!-- header: ... -->` y `<!-- footer: ... -->`; los números de página se omiten |
| Notas al pie | Al final de su página |
| Cuadros de texto, barras laterales | En orden de lectura |
| Casillas, campos de formulario | ☑ y ☐; líneas `key: value` |

## Bloques de diseño

Con `layout=true`, cada parte leída por OCR incluye `blocks`, las regiones de su página.

| Campo | Significado |
| - | - |
| `type` | `title`, `text`, `list`, `table`, `image`, `header`, `footer`, `page_number`, ... |
| `bbox` | `[x0, y0, x1, y1]` como fracciones de la página desde su esquina superior izquierda |
| `order` | Orden de lectura |
| `content` | El texto del bloque |
| `conf` | La certeza del OCR |

## Imágenes en Word y PowerPoint

Cada imagen se lee mediante OCR, sea cual sea su tamaño en la página; al subirla, cada una es una parte del documento del archivo ([ubicaciones](https://docs.conare.ai/es/files.md#documentos-almacenados)).

* Se omiten como iconos o decoraciones: menos de 64 píxeles en ambos lados, menos de 16 píxeles en el lado más corto, o mostradas a menos de media pulgada en ambos lados.
* Una imagen que se repite en una diapositiva posterior se lee una sola vez, donde aparece por primera vez.

Cada imagen que no dio texto figura en `without_text.images` con su `reason`:

| `reason` | Significado |
| - | - |
| `too_small` | Un icono o decoración, con su `width` y `height` en píxeles |
| `not_raster` | Una imagen vectorial (EMF, WMF, SVG), que no se lee |
| `unreadable` | La imagen está dañada |
| `not_read` | El OCR no pudo leerla a tiempo |
| `no_text` | El OCR no encontró texto |

## Aún no compatible

* Extracción a un esquema JSON.
* Opciones de fragmentación en `POST /parse`: devuelve las partes y el archivo completo.


## Related topics

- [Archivos](https://docs.conare.ai/es/files.md)
- [Google Cloud Storage](https://docs.conare.ai/es/gcs.md)
- [Descripción general de la API](https://docs.conare.ai/es/api.md)
- [Upload a file](https://docs.conare.ai/es/api-reference/files/upload-a-file.md)
- [SDK de TypeScript](https://docs.conare.ai/es/sdk.md)


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