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 صحيحة وتنتمي إليك.
415Content-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.

تحتاج المزيد؟ اتصل بنا للحصول على تسعير مؤسسي مخصص.