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

# أنواع الملفات وMarkdown

> صيغ الملفات التي يقرؤها Conare، وكيف يتحوّل كلٌّ منها إلى Markdown، وكيف تُقرأ الصور والتخطيط.

ينطبق ما يلي على [مساري الملفات](https://docs.conare.ai/ar/files.md) كليهما: الرفع و`POST /parse`.

## أنواع الملفات

| الملف | الامتدادات | `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 و5.0/95)، `.ods`؛ لا تُشغَّل وحدات الماكرو أبدًا | `xlsx`، `ods` (تعمل `xls` و`xlsm` أيضًا) |
| CSV، TSV | `.csv`، `.tsv` | `csv`، `tsv` |
| النص، Markdown | `.txt`، `.md` | `txt`، `md` |
| الصور | `.png`، `.jpg`، `.webp`، `.tif` (كل الصفحات)، `.gif` (الإطار الأول)، `.bmp`، `.heic`، `.heif` | `png`، `jpeg`، `webp`، `tiff`، `gif`، `bmp`، `heic` (تعمل `jpg` و`tif` و`heif` أيضًا) |

| طريقة القراءة | |
| - | - |
| صفحات PDF | تُقرأ كل صفحة فيها محتوى بواسطة OCR، حتى الرقمية الأصل، فتُحفظ الجداول والعناوين وترتيب القراءة |
| صفحة يتخطّاها OCR | تحتفظ بطبقة النص الخاصة بها |
| `.doc`، `.rtf`، `.odt` | تُقرأ كـ Word (`docx`)؛ و`.ppt` و`.odp` كـ PowerPoint (`pptx`)؛ و`.xls` و`.ods` كـ Excel (`xlsx`) |
| جداول `.ppt` | تُقرأ كنصوص خلاياها، خلية في كل سطر |
| المخططات البيانية | عنوانها وعناوين محاورها وجدول بقيمها |

تُرفض بـ `415 unsupported_file`:

| الملف | احفظه بصيغة |
| - | - |
| Word 6.0/95 | `.docx` |
| صور AVIF | JPEG أو PNG |

## Markdown

| العنصر | يُكتب كـ |
| - | - |
| الصفحة، الشريحة، الورقة | تبدأ بـ `<!-- page 3 -->` أو `<!-- slide 4 -->` أو `<!-- sheet "Q3" -->` |
| العناوين، القوائم | `#` و`##`؛ `-` و`1.` |
| الجداول | Markdown مع صف عناوين؛ و`<table>` بصيغة HTML مع `colspan` و`rowspan` عند دمج الخلايا أو تجاوز 30 عمودًا أو 300 صف |
| الأرقام | تمامًا كما طُبعت |
| الترويسة والتذييل المتكرران | `<!-- header: ... -->` و`<!-- footer: ... -->`؛ تُحذف أرقام الصفحات |
| الحواشي | في نهاية صفحتها |
| مربعات النص، الأشرطة الجانبية | بترتيب القراءة |
| مربعات الاختيار، حقول النماذج | ☑ و☐؛ أسطر `key: value` |

## كتل التخطيط

مع `layout=true`، يحمل كل جزء قرأه OCR قيمة `blocks`، وهي مناطق صفحته.

| الحقل | المعنى |
| - | - |
| `type` | `title`، `text`، `list`، `table`، `image`، `header`، `footer`، `page_number`، ... |
| `bbox` | `[x0, y0, x1, y1]` كنِسَب من الصفحة بدءًا من زاويتها العلوية اليسرى |
| `order` | ترتيب القراءة |
| `content` | نص الكتلة |
| `conf` | درجة ثقة OCR |

## الصور في Word وPowerPoint

تُقرأ كل صورة بواسطة OCR، أيًّا كان حجمها في الصفحة؛ وعند الرفع تصبح كلٌّ منها جزءًا من مستند الملف ([المواضع](https://docs.conare.ai/ar/files.md#المستندات-المخزّنة)).

* تُتخطّى كأيقونات أو زخارف: أقل من 64 بكسل في كلا البعدين، أو أقل من 16 بكسل في البعد الأقصر، أو معروضة بأقل من نصف بوصة في كلا البعدين.
* الصورة المستخدمة مجددًا في شريحة لاحقة تُقرأ مرة واحدة، حيث تظهر أولًا.

كل صورة لم تُعطِ نصًا تكون في `without_text.images` مع `reason` الخاص بها:

| `reason` | المعنى |
| - | - |
| `too_small` | أيقونة أو زخرفة، مع `width` و`height` بالبكسل |
| `not_raster` | صورة متجهية (EMF، WMF، SVG)، لا تُقرأ |
| `unreadable` | الصورة تالفة |
| `not_read` | تعذّر على OCR قراءتها في الوقت المحدد |
| `no_text` | لم يجد OCR أي نص |

## غير مدعوم بعد

* الاستخراج إلى مخطط JSON.
* خيارات التقسيم إلى مقاطع في `POST /parse`: فهو يُرجع الأجزاء والملف كاملًا.


## Related topics

- [الملفات](https://docs.conare.ai/ar/files.md)
- [Upload a file](https://docs.conare.ai/ar/api-reference/files/upload-a-file.md)
- [Read a file](https://docs.conare.ai/ar/api-reference/files/read-a-file.md)
- [المصادر](https://docs.conare.ai/ar/sources.md)
- [Google Cloud Storage](https://docs.conare.ai/ar/gcs.md)


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