> ## 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.

# Types de fichiers et Markdown

> Les formats de fichiers que Conare lit, comment chacun devient du Markdown, et comment images et mise en page sont lues.

Ces règles s'appliquent aux deux [routes de fichiers](https://docs.conare.ai/fr/files.md) : les uploads et `POST /parse`.

## Types de fichiers

| Fichier | Extensions | `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 et 5.0/95), `.ods` ; les macros ne s'exécutent jamais | `xlsx`, `ods` (`xls`, `xlsm` fonctionnent aussi) |
| CSV, TSV | `.csv`, `.tsv` | `csv`, `tsv` |
| Texte, Markdown | `.txt`, `.md` | `txt`, `md` |
| Images | `.png`, `.jpg`, `.webp`, `.tif` (chaque page), `.gif` (première image), `.bmp`, `.heic`, `.heif` | `png`, `jpeg`, `webp`, `tiff`, `gif`, `bmp`, `heic` (`jpg`, `tif`, `heif` fonctionnent aussi) |

| Mode de lecture | |
| - | - |
| Pages PDF | Toute page non vide est lue par OCR, même les PDF natifs, pour conserver tableaux, titres et ordre de lecture |
| Une page ignorée par l'OCR | Garde sa propre couche de texte |
| `.doc`, `.rtf`, `.odt` | Lus comme Word (`docx`) ; `.ppt`, `.odp` comme PowerPoint (`pptx`) ; `.xls`, `.ods` comme Excel (`xlsx`) |
| Tableaux `.ppt` | Lus comme le texte de leurs cellules, une par ligne |
| Graphiques | Leur titre, les titres des axes et un tableau de leurs valeurs |

Refusés avec `415 unsupported_file` :

| Fichier | Enregistrez-le en |
| - | - |
| Word 6.0/95 | `.docx` |
| Images AVIF | JPEG ou PNG |

## Markdown

| Élément | Écrit sous la forme |
| - | - |
| Page, diapositive, feuille | Commence par `<!-- page 3 -->`, `<!-- slide 4 -->` ou `<!-- sheet "Q3" -->` |
| Titres, listes | `#` et `##` ; `-` et `1.` |
| Tableaux | Markdown avec une ligne d'en-tête ; un `<table>` HTML avec `colspan` et `rowspan` si des cellules sont fusionnées ou s'il dépasse 30 colonnes ou 300 lignes |
| Nombres | Exactement tels qu'imprimés |
| En-tête et pied de page courants | `<!-- header: ... -->` et `<!-- footer: ... -->` ; les numéros de page sont omis |
| Notes de bas de page | À la fin de leur page |
| Zones de texte, encadrés | Dans l'ordre de lecture |
| Cases à cocher, champs de formulaire | ☑ et ☐ ; lignes `key: value` |

## Blocs de mise en page

Avec `layout=true`, chaque partie lue par OCR porte `blocks`, les régions de sa page.

| Champ | Signification |
| - | - |
| `type` | `title`, `text`, `list`, `table`, `image`, `header`, `footer`, `page_number`, ... |
| `bbox` | `[x0, y0, x1, y1]` en proportions de la page depuis son coin supérieur gauche |
| `order` | Ordre de lecture |
| `content` | Le texte du bloc |
| `conf` | La confiance de l'OCR |

## Images dans Word et PowerPoint

Chaque image est lue par OCR, quelle que soit sa taille sur la page ; à l'upload, chacune est une partie du document du fichier ([emplacements](https://docs.conare.ai/fr/files.md#documents-stockés)).

* Ignorées comme icônes ou décorations : moins de 64 pixels sur les deux côtés, moins de 16 pixels sur le petit côté, ou affichées à moins d'un demi-pouce sur les deux côtés.
* Une image réutilisée sur une diapositive ultérieure n'est lue qu'une fois, là où elle apparaît d'abord.

Chaque image sans texte figure dans `without_text.images` avec sa `reason` :

| `reason` | Signification |
| - | - |
| `too_small` | Une icône ou décoration, avec sa `width` et sa `height` en pixels |
| `not_raster` | Une image vectorielle (EMF, WMF, SVG), qui n'est pas lue |
| `unreadable` | L'image est endommagée |
| `not_read` | L'OCR n'a pas pu la lire à temps |
| `no_text` | L'OCR n'a trouvé aucun texte |

## Pas encore pris en charge

* L'extraction vers un schéma JSON.
* Les options de découpage sur `POST /parse` : la route renvoie les parties et le fichier entier.


## Related topics

- [Fichiers](https://docs.conare.ai/fr/files.md)
- [SDK TypeScript](https://docs.conare.ai/fr/sdk.md)
- [Google Cloud Storage](https://docs.conare.ai/fr/gcs.md)
- [Introduction](https://docs.conare.ai/fr/index.md)
- [Embedding et reranking](https://docs.conare.ai/fr/embed-rerank.md)


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