Документы → Markdown

Любой документ — в чистый Markdown

PDF, Word, Excel, PowerPoint и сканы превращаются в текст, который понимают языковые модели, или в картинки страниц — если важна вёрстка. Один запрос, один ключ.

Панель администратора Смотреть API

Доступ только по ключам. Ключи выдаёт администратор в панели.

$ curl -H "Authorization: Bearer mdk_…" \
       -F file=@отчёт.docx \
       /v1/convert

{
  "mode": "text",
  "markdown": "# Отчёт по проекту\n\n
    Секретное слово: МАНДАРИН.\n\n
    | Имя  | Балл |\n| ---- | ---- |\n
    | Анна | 5    |"
}

Что умеет сервис

Превращает файлы в удобный для работы вид и не требует ничего устанавливать — только ключ и HTTP-запрос.

Текст с сохранением структуры

Заголовки, списки и таблицы остаются таблицами и списками, а не превращаются в сплошной текст.

Сканы без текстового слоя

Если в PDF нет текста, сервис сам вернёт страницы картинками со ссылками — их можно отдать модели, которая умеет читать изображения.

Любой файл — картинками

Параметр images=force рисует страницы PDF, документов Office, html, csv, текста и картинок: видно оформление, схемы и подписи.

Как это работает

Три шага от файла до результата.

Получите ключАдминистратор создаёт ключ в панели. Он показывается один раз — сохраните его сразу.
Отправьте файлPOST-запрос с файлом на /v1/convert, ключ — в заголовке Authorization.
Заберите результатMarkdown в ответе или JSON со ссылками на страницы. Картинки хранятся сутки с последнего обращения.

Форматы

Текст извлекается из документов, таблиц, презентаций и данных. В картинки отрисовываются документы и изображения.

pdf
docx
doc
xlsx
xls
pptx
ppt
odt
rtf
html
csv
json
xml
txt
zip
epub
png
jpg
mp3 / wav

API

Одна точка входа. Все запросы — с заголовком Authorization: Bearer <ключ>.

Текст документа

# JSON с полем markdown
curl -H "Authorization: Bearer $KEY" \
     -F file=@report.pdf \
     URL/v1/convert

# только Markdown, без обёртки
curl -H "Authorization: Bearer $KEY" \
     -F file=@report.pdf \
     "URL/v1/convert?format=markdown"

Страницы картинками

# любой файл → картинки страниц
curl -H "Authorization: Bearer $KEY" \
     -F file=@slides.pptx \
     "URL/v1/convert?images=force&image_format=png"

# скачать страницу по ссылке из ответа
curl -H "Authorization: Bearer $KEY" \
     -o page-001.png URL/v1/files/<job>/page-001.png

Параметры `/v1/convert`

`images`	auto — текст, а PDF без текстового слоя страницами; never — только текст; force — всегда страницами
`format`	json (по умолчанию) или markdown — чистый текст. Если результат картинки, ответ всегда JSON
`image_format`	jpeg (по умолчанию) или png
`max_pages`	Сколько страниц отрисовать, до 50

Ограничения

Размер файла	до 50 МБ
Время обработки	до 2 минут на файл
Хранение картинок	1 сутки с последнего обращения к ним; удалить раньше можно запросом `DELETE /v1/files/<job>`
Доступ к картинкам	только по ключу, которым был сделан запрос

Нужен ключ?

Ключи создаются и отзываются в панели администратора. Отозванный ключ перестаёт работать сразу.

Открыть панель администратора