Markdown Converter API для разработчиков
Конвертируйте Markdown, PDF, Word и HTML программно через единственный REST-эндпоинт. Полный рендеринг математических формул LaTeX и диаграмм Mermaid — готово к вызову из любого языка. Получите API-ключ на RapidAPI и начните конвертировать за считанные минуты.
Быстрый старт с Markdown Conversion API
Всего два запроса: отправьте файл и получите task ID, затем опрашивайте API для получения ссылки на скачивание. Все эндпоинты работают по одной схеме.
# 1. Submit a Markdown file for PDF conversion
curl -X POST "https://markdown-converter-pro.p.rapidapi.com/apix/md-to-pdf" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: markdown-converter-pro.p.rapidapi.com" \
-F "source_file=@README.md"
# -> { "task_id": "550e8400-...", "status": "processing" }
# 2. Poll for the result until status is "completed"
curl -X POST "https://markdown-converter-pro.p.rapidapi.com/apix/query-task" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: markdown-converter-pro.p.rapidapi.com" \
-d "task_id=550e8400-..."
# -> { "status": "completed", "to_url": "https://.../README.pdf" }1. Отправьте запрос на конвертацию
Загрузите файл (source_file) или передайте публичный URL (source_file_url). В ответ вернётся task_id.
2. Опросите API для получения результата
Периодически вызывайте query-task с task_id, пока статус не станет completed, затем скачайте файл по to_url.
Эндпоинты API Markdown → PDF, Word и HTML
Все эндпоинты принимают POST с multipart/form-data и возвращают task_id. Базовый путь: /apix.
| Метод | Эндпоинт | Описание | Онлайн-инструмент |
|---|---|---|---|
| POST | /apix/md-to-pdf | Конвертация Markdown в PDF с рендерингом LaTeX и Mermaid. | Попробовать онлайн |
| POST | /apix/md-to-docx | Конвертация Markdown в редактируемый Word-документ (.docx). | Попробовать онлайн |
| POST | /apix/md-to-html | Конвертация Markdown в чистый семантический HTML. | Попробовать онлайн |
| POST | /apix/pdf-to-md | Извлечение Markdown из PDF — включая текст, таблицы и изображения. | Попробовать онлайн |
| POST | /apix/docx-to-md | Конвертация Word-документа (.docx) в Markdown. | Попробовать онлайн |
| POST | /apix/html-to-md | Конвертация HTML-страницы или фрагмента в чистый Markdown. | Попробовать онлайн |
| POST | /apix/query-task | Опрос задачи по task_id и получение ссылки на скачивание по готовности. | — |
Как работает асинхронный API конвертации
Конвертация выполняется асинхронно — большие файлы не блокируют ваш запрос.
Отправка
Отправьте POST-запрос с файлом Markdown, PDF, Word или HTML — в виде загрузки или публичного URL — на соответствующий эндпоинт.
Получение task ID
API немедленно возвращает task_id со статусом processing. Соединение не блокируется.
Опрос и скачивание
Вызовите query-task с task_id. Когда статус станет completed, скачайте готовый файл по ссылке to_url из ответа.
Что умеет рендерить Markdown Converter API
От формул LaTeX до диаграмм Mermaid — API преобразует сложный Markdown в аккуратные PDF, Word и HTML без потери точности.
Математика LaTeX
Встроенные и блочные формулы LaTeX точно рендерятся в PDF и Word — идеально для академических и технических документов.
Диаграммы Mermaid
Блок-схемы, диаграммы последовательностей, диаграммы Ганта и классов на Mermaid рендерятся как полноценная графика.
Полная поддержка GFM
Таблицы с пайпами, списки задач, блоки кода с подсветкой синтаксиса, зачёркивание и авто-ссылки — всё сохраняется.
Двунаправленная конвертация
Конвертируйте из Markdown в PDF, Word и HTML — или в обратную сторону, в чистый Markdown, удобный для системы контроля версий.
Сценарии использования Markdown Conversion API
Разработчики используют API для автоматической генерации документов — в пайплайнах сборки, функциях продукта и пакетных задачах.
CI/CD-пайплайны
Генерируйте заметки о релизах, отчёты или PDF-артефакты из Markdown при каждой сборке — без headless-браузера в инфраструктуре.
Инструменты для документации
Автоматически превращайте Markdown-документы в загружаемые PDF или Word для пользователей, клиентов и офлайн-чтения.
Пакетная конвертация
Обрабатывайте большие наборы документов на сервере, передавая публичные URL файлов, и собирайте результаты по task ID.
Тарифы Markdown Converter API
API тарифицируется через RapidAPI: есть бесплатный уровень для старта и платные планы, которые масштабируются вместе с нагрузкой. Биллинг, ключи и лимиты запросов управляются через ваш аккаунт RapidAPI.
Basic
30
запросов / месяц
Pro
800
запросов / месяц
+ $0.02 / request
Ultra
4,000
запросов / месяц
+ $0.012 / request
Mega
12,000
запросов / месяц
+ $0.008 / request
Квоты и цены задаются на RapidAPI и могут меняться — актуальные данные смотрите в описании планов.
Посмотреть планы на RapidAPIFAQ по интеграции Markdown API
Всё необходимое для первого запуска: подписка, аутентификация, отправка запросов и выбор тарифного плана для API конвертации Markdown.
Как начать пользоваться API конвертации Markdown?
Зарегистрируйте бесплатный аккаунт на RapidAPI, откройте Markdown Converter Pro в RapidAPI Hub и подпишитесь на план — тариф Basic бесплатный. После подписки можно сразу вызывать любой эндпоинт, используя примеры кода выше.
Где найти свой API-ключ?
После подписки RapidAPI выдаёт персональный API-ключ для вашего аккаунта. Он доступен в дашборде RapidAPI и на вкладке Code Snippets любого эндпоинта. Передавайте его в каждом запросе в заголовке X-RapidAPI-Key вместе с заголовком X-RapidAPI-Host, указанным рядом.
Какие конвертации поддерживает API?
API включает шесть эндпоинтов конвертации — Markdown в PDF, Word и HTML, а также обратные направления: из PDF, Word и HTML обратно в Markdown — плюс эндпоинт query-task для получения результатов. Точные пути перечислены в таблице эндпоинтов выше.
Какие параметры нужны для запроса на конвертацию?
Каждый эндпоинт конвертации принимает запрос multipart/form-data с одним из двух полей: source_file для прямой загрузки файла или source_file_url для указания на публично доступный файл. Используйте что-то одно — если переданы оба, приоритет у source_file. Размер файла — до 50 MB, тип файла должен соответствовать эндпоинту: например, md-to-pdf ожидает файл .md.
Как получить сконвертированный файл?
Конвертация выполняется асинхронно: успешный запрос возвращает task_id, а не сам файл. Передайте task_id в эндпоинт query-task и продолжайте опрашивать его, пока статус не станет completed, — после этого скачайте готовый файл по ссылке to_url из ответа.
Что происходит при ошибке конвертации?
Если конвертацию завершить не удаётся, query-task возвращает статус failed вместо completed. Наиболее частые причины: тип файла не соответствует эндпоинту, source_file_url недоступен публично, или размер файла превышает 50 MB. Исправьте входные данные и отправьте запрос заново.
Какой тарифный план выбрать?
Начните с бесплатного плана Basic, чтобы протестировать интеграцию, а затем переходите на платный по мере роста ежемесячного объёма запросов. Каждый план включает месячную квоту запросов и небольшую плату за сверхлимитные запросы — актуальные уровни показаны в таблице тарифов выше. Биллинг и лимиты управляются в вашем аккаунте RapidAPI.
Что происходит с файлами после конвертации?
Файлы не хранятся. Загруженные документы и результаты конвертации обрабатываются временно и удаляются после завершения; готовые файлы выдаются по короткоживущей ссылке для скачивания, а не хранятся долгосрочно.
Начните конвертировать за несколько минут
Подпишитесь на RapidAPI, получите ключ и сделайте первый запрос уже сегодня.
Начать работу на RapidAPI