Документация API
Преобразуйте Markdown в PDF программно. Наша REST API позволяет создавать профессиональные, стилизованные PDF из содержимого Markdown с помощью одного HTTP-запроса.
Быстрый старт
Создайте PDF за 30 секунд с помощью простой команды curl.
Получите ключ API
Создайте ключ в панели управления в разделе API Keys.
Напишите Markdown
Поддерживается любой корректный Markdown — заголовки, списки, блоки кода, таблицы, изображения.
Выполните запрос
Отправьте POST-запрос с вашим ключом и Markdown. Получите PDF в ответ.
curl -X POST https://markdowntopdfconverter.com/api/v1/convert \
-H "Authorization: Bearer mp_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{"markdown": "# Hello World\n\nThis is a **test**.", "templateId": "clean"}' \
-o output.pdfАутентификация
apiDocs.authentication.description
Заголовок запроса
| Заголовок | Значение | Описание |
|---|---|---|
| Authorization | Bearer mp_live_... | Ваш ключ API с префиксом Bearer |
| Content-Type | application/json | Обязательно для всех запросов |
apiDocs.authentication.keyFormat
POST /api/v1/convert
Преобразуйте Markdown в стилизованный PDF-документ.
Тело запроса
markdownstringОбязательноСодержимое Markdown для конвертации. Макс. 200 000 символов.
templateIdstringОпциональноШаблон для использования. Один из: clean, executive, resume, academic, legal, creative. По умолчанию: clean.
filenamestringОпциональноИмя загружаемого PDF-файла. По умолчанию: document.pdf.
localestringОпциональноЛокаль для отображения. Один из: en, es, fr, de, ja, zh-CN, ko, pt-BR, ar, ru, hi, it. По умолчанию: en.
customTemplateIdUUIDОпциональноUUID сохранённого пользовательского шаблона. Шаблон должен принадлежать пользователю ключа API.
optionsobjectОпциональноОпции конвертации: pageNumbers (boolean), bodyTextColor (hex), headingTextColor (hex), creativeAccent (slate|purple|blue|emerald|rose|amber).
Примеры запросов
import requests
api_key = "mp_live_your_api_key_here"
headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
}
payload = {
"markdown": "# Quarterly Report\n\n## Revenue\n\nRevenue grew **15%** this quarter.",
"templateId": "executive",
"options": {"pageNumbers": True}
}
response = requests.post(
"https://markdowntopdfconverter.com/api/v1/convert",
json=payload,
headers=headers
)
with open("report.pdf", "wb") as f:
f.write(response.content)const response = await fetch(
"https://markdowntopdfconverter.com/api/v1/convert",
{
method: "POST",
headers: {
Authorization: `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
markdown: "# Invoice\n\n**Amount:** $1,200\n\n| Item | Qty | Price |\n| --- | --- | --- |\n| Widget | 5 | $240 |",
templateId: "clean",
filename: "invoice",
}),
}
);
const blob = await response.blob();
const url = URL.createObjectURL(blob);
// Trigger download
const a = document.createElement("a");
a.href = url;
a.download = "invoice.pdf";
a.click();Шаблоны
Выберите из шести профессионально разработанных шаблонов. Каждый шаблон имеет уникальную типографику, интервалы и цветовые схемы.
Clean
Минималистичный, современный дизайн без засечек с чистыми интервалами.
Executive
Заголовки с засечками с профессиональными тёмно-синими акцентами и номерами страниц.
Resume
Компактный одноколоночный макет, оптимизированный для резюме.
Academic
Пронумерованные заголовки, щедрые интервалы и шрифт EB Garamond для основного текста.
Legal
Текст с засечками через двойной интервал с формальным форматированием цитат.
Creative
Жирные заголовки DM Sans с настраиваемыми акцентными цветами.
Коды ошибок
Каждый ответ использует стандартный HTTP-статус. Используйте его, чтобы решить, как обработать результат.
| Статус | Значение | Действие |
|---|---|---|
| 200 | Успех — PDF возвращён | Скачайте PDF из тела ответа. |
| 400 | Неверное тело запроса | Проверьте, что ваш JSON-пайлоад соответствует схеме выше. |
| 401 | Недействительный или отсутствующий ключ API | Убедитесь, что ваш ключ API активен и имеет правильный формат. |
| 402 | Кредиты API исчерпаны | Купите больше кредитов в панели управления. |
| 404 | Пользовательский шаблон не найден | Проверьте, что customTemplateId корректен и принадлежит вам. |
| 415 | Неправильный Content-Type | Установите заголовок Content-Type на application/json. |
| 422 | Недействительные опции конвертации | Проверьте, что ваш объект options соответствует спецификации. |
| 429 | Превышен лимит запросов | Подождите и повторите. Проверьте заголовок Retry-After. |
| 500 | Ошибка сервера | Повторите с экспоненциальной задержкой. Свяжитесь с поддержкой при повторном возникновении. |
Цены API
Вызовы API учитываются ежемесячно. Каждое успешное преобразование учитывается в ежемесячном лимите вашего тарифа.
$0
25 / month
Для тестирования и оценки.
$9
500 / month
Для частных лиц и небольших проектов.
$29
1,000 / month
Приоритетная генерация, поддержка пользовательских шаблонов через API.
Нужно больше? Свяжитесь с нами для индивидуальных корпоративных цен.