> ## 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/ja/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` の表 | セルのテキストとして 1 行に 1 つずつ読み取ります |
| グラフ | タイトル、軸タイトル、値の表 |

`415 unsupported_file` で拒否されるもの:

| ファイル | 保存し直す形式 |
| - | - |
| Word 6.0/95 | `.docx` |
| AVIF 画像 | JPEG または PNG |

## Markdown

| 要素 | 出力形式 |
| - | - |
| ページ、スライド、シート | `<!-- page 3 -->`、`<!-- slide 4 -->`、`<!-- sheet "Q3" -->` で始まります |
| 見出し、リスト | `#` と `##`、`-` と `1.` |
| 表 | ヘッダー行付きの Markdown。セルが結合されている場合や 30 列または 300 行を超える場合は、`colspan` と `rowspan` を使った HTML の `<table>` |
| 数値 | 印刷どおり正確に |
| 柱(ヘッダーとフッター) | `<!-- 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/ja/files.md#保存されるドキュメント))。

* アイコンや装飾としてスキップされるもの: 縦横とも 64 ピクセル未満、短辺が 16 ピクセル未満、または縦横とも 0.5 インチ未満で表示されているもの。
* 後のスライドで再利用された画像は、最初に現れた箇所で 1 回だけ読み取られます。

テキストが得られなかった画像は、`reason` とともに `without_text.images` に含まれます。

| `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/ja/files.md)
- [Google Cloud Storage](https://docs.conare.ai/ja/gcs.md)
- [API の概要](https://docs.conare.ai/ja/api.md)
- [Upload a file](https://docs.conare.ai/ja/api-reference/files/upload-a-file.md)
- [Read a file](https://docs.conare.ai/ja/api-reference/files/read-a-file.md)


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