Markdown to PDF
v1.0REST API

Документация API

Преобразуйте Markdown в PDF программно. Наша REST API позволяет создавать профессиональные, стилизованные PDF из содержимого Markdown с помощью одного HTTP-запроса.

Быстрый старт

Создайте PDF за 30 секунд с помощью простой команды curl.

1

Получите ключ API

Создайте ключ в панели управления в разделе API Keys.

2

Напишите Markdown

Поддерживается любой корректный Markdown — заголовки, списки, блоки кода, таблицы, изображения.

3

Выполните запрос

Отправьте POST-запрос с вашим ключом и Markdown. Получите PDF в ответ.

cURL
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

Заголовок запроса

ЗаголовокЗначениеОписание
AuthorizationBearer mp_live_...Ваш ключ API с префиксом Bearer
Content-Typeapplication/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).

Примеры запросов

Python
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)
JavaScript
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

Clean

Минималистичный, современный дизайн без засечек с чистыми интервалами.

executive

Executive

Заголовки с засечками с профессиональными тёмно-синими акцентами и номерами страниц.

resume

Resume

Компактный одноколоночный макет, оптимизированный для резюме.

academic

Academic

Пронумерованные заголовки, щедрые интервалы и шрифт EB Garamond для основного текста.

legal

Legal

Текст с засечками через двойной интервал с формальным форматированием цитат.

creative

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 учитываются ежемесячно. Каждое успешное преобразование учитывается в ежемесячном лимите вашего тарифа.

Free

$0

25 / month

Для тестирования и оценки.

Starter

$9

500 / month

Для частных лиц и небольших проектов.

Pro

$29

1,000 / month

Приоритетная генерация, поддержка пользовательских шаблонов через API.

Нужно больше? Свяжитесь с нами для индивидуальных корпоративных цен.