Markdown to PDF
v2 public betaREST API

واجهة API وخادم MCP لتحويل Markdown إلى PDF مصقول ومخصص للمهمة

أنشئ مستندات Markdown ذات إصدارات، وانشر ملفات PDF مصقولة بشكل غير متزامن، ونزّل ملفات موثقة عبر REST API بصلاحيات محددة.

تجربة premium

POST/api/v2/documents
{
  "taskId": "consulting-proposal",
  "revision": {
    "markdown": "# Northstar Proposal...",
    "spec": { "templateId": "proposal-consulting" }
  }
}
Executive template API request and PDF preview
verified artifactSHA-256

بدء سريع

أنشئ مستندًا وانشره ثم نزّل ملف PDF الموثق.

cURL
#!/usr/bin/env bash
set -euo pipefail

API="https://markdowntopdfconverter.com"
RUN_ID="proposal-$(date +%s)"
AUTH="Authorization: Bearer $MD2PDF_API_KEY"

DOCUMENT=$(curl --fail --silent --show-error --max-time 30 "$API/api/v2/documents" \
  -H "$AUTH" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $RUN_ID-document" \
  --data '{"taskId":"consulting-proposal","title":"Northstar proposal","revision":{"markdown":"# Northstar Proposal\n\n## Outcome\nA decision-ready roadmap.","parentRevisionId":null,"spec":{"locale":"en","options":{"pageNumbers":true},"templateId":"proposal-consulting"}}}')

DOCUMENT_ID=$(jq -r '.document.id' <<<"$DOCUMENT")
REVISION_ID=$(jq -r '.revision.id' <<<"$DOCUMENT")
JOB=$(curl --fail --silent --show-error --max-time 30 \
  "$API/api/v2/documents/$DOCUMENT_ID/publishes" \
  -H "$AUTH" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $RUN_ID-publish" \
  --data "{"revisionId":"$REVISION_ID","output":{"format":"pdf","filename":"northstar-proposal.pdf"}}")
JOB_ID=$(jq -r '.job.id' <<<"$JOB")

for ATTEMPT in $(seq 1 100); do
  RESULT=$(curl --fail --silent --show-error --max-time 30 "$API/api/v2/jobs/$JOB_ID" -H "$AUTH")
  STATUS=$(jq -r '.job.status' <<<"$RESULT")
  [[ "$STATUS" == "succeeded" ]] && break
  [[ "$STATUS" == "failed" || "$STATUS" == "cancelled" ]] && exit 1
  sleep 3
done
[[ "$STATUS" == "succeeded" ]] || { echo "Timed out waiting for PDF" >&2; exit 1; }

ARTIFACT_ID=$(jq -r '.artifact.id' <<<"$RESULT")
LINK=$(curl --fail --silent --show-error --max-time 30 -X POST \
  "$API/api/v2/artifacts/$ARTIFACT_ID/links" -H "$AUTH")
HREF=$(jq -r '.href' <<<"$LINK")
[[ "$HREF" == https://* ]] || { echo "Refusing non-HTTPS artifact URL" >&2; exit 1; }
curl --fail --location --proto '=https' --max-redirs 5 --max-time 60 "$HREF" \
  --output northstar-proposal.pdf
Verified PDFsucceeded
Polished consulting proposal PDF returned by the publishing API
Artifact
SHA-256
Download
private link

ابدأ بأتمتة تمت مراجعتها

استورد مسار النشر والمتابعة والتنزيل الخاص كاملًا.

n8n

سير عمل غير نشط مع انتظار مستمر ومعالجة حالات الفشل النهائية.

تنزيل سير العمل

Make

مخطط بلا بيانات اعتماد مع متابعة محدودة ومنع التنزيل المكرر.

تنزيل المخطط

Zapier

خطوة SDK وبيان قالب إرشادي في حزمة واحدة.

تنزيل حزمة الإعداد

استخدم مفتاحًا مخصصًا بصلاحيتي documents.render وdocuments.read. نزّل الرابط الموقّع من دون هذا المفتاح.


استخدم قوالب PDF المصقولة من Claude Code ووكلاء الذكاء الاصطناعي

اربط خادم MCP البعيد مرة واحدة، ثم اطلب من الوكيل اقتراح أنسب القوالب لمستندك أو تحويل Markdown إلى PDF مصقول من داخل المحادثة.

.mcp.json
{
  "mcpServers": {
    "markdown-to-pdf": {
      "type": "http",
      "url": "https://markdowntopdfconverter.com/mcp",
      "headers": {
        "Authorization": "Bearer ${MD2PDF_API_KEY}"
      }
    }
  }
}

يستخدم MCP مفتاح API والحصة نفسيهما في REST API. كل نتيجة رابط تنزيل خاص تنتهي صلاحيته بعد 15 دقيقة، ويمكن للحسابات المجانية تجربة 5 تصديرات مميزة قبل الترقية.

إنشاء مفتاح API

المصادقة

تحقّق من كل طلب باستخدام مفتاح API السري الخاص بك، المُرسَل كرمز Bearer في ترويسة Authorization.

ترويسة الطلب

الترويسةالقيمةالوصف
AuthorizationBearer mp_live_...مفتاح API الخاص بك مسبوقًا بـ Bearer
Content-Typeapplication/jsonمطلوب لجميع الطلبات

دورة نشر مُدارة واحدة

يبقى المصدر والمراجعة الثابتة والمهمة والملف الموثق منفصلة لتكون الإعادات والتدقيقات متوقعة.

  1. 01

    أنشئ مستندًا مُدارًا ومراجعته الأولى.

  2. 02

    اطلب ملف PDF النهائي بمفتاح ثبات مستقر.

  3. 03

    تابع حتى succeeded أو failed أو cancelled.

  4. 04

    أنشئ رابطًا خاصًا قصير الصلاحية للملف.

  5. 05

    نزّل الرابط الموقّع من دون تمرير Authorization.


POST /api/v1/convert

حول Markdown إلى مستند PDF منسق.


القوالب

اختر من بين 57 قالبًا احترافيًا ضمن 9 عائلات مخصّصة للمهام. افتح أي عائلة لنسخ معرّف القالب.

تنفيذي PDFالتقارير والموجزاتتقارير الأعمال والمقترحات والموجزات البصرية.2 IDs
تحرير عصري PDFالسير الذاتيةتنسيقات واضحة ومهنية لانطباع أول قوي.10 IDs
ترويسة عصرية PDFخطابات التقديمخطابات مصممة لتتكامل مع سيرتك الذاتية.10 IDs
مقال المرحلة الثانوية PDFالواجبات الدراسيةتنسيقات متقنة لواجبات المدرسة والكلية والجامعة.9 IDs
مقترح استشاري PDFالمقترحاتمقترحات احترافية لكسب العملاء والموافقات والشراكات والتمويل.9 IDs
صفحة منتج PDFالمبيعات والتسويقمواد مصقولة للبيع وإثبات النتائج وإطلاق المنتجات.9 IDs
بحث منشور PDFالمستندات الأكاديميةتنسيقات للنشر والتحكيم وأوراق المؤتمرات.3 IDs
نظيف PDFالكتب والنصوص الطويلةتخطيطات مريحة للقراءة للأدلة والكتيبات والمقالات والكتب.4 IDs
قانوني PDFالمستندات القانونيةاتفاقيات وعقود منظمة بوضوح.1 IDs

أكواد الخطأ

يتضمن كل خطأ في v2 رمزًا ثابتًا وحالة HTTP وعلامة retryable وتأخيرًا اختياريًا لإعادة المحاولة. أعد المحاولة فقط عندما تكون retryable مساوية لـ true.

400 / 415 / 422invalid_request

retryable: false

401unauthorized

retryable: false

402quota_exhausted

retryable: false

403forbidden

retryable: false

404not_found

retryable: false

409idempotency_conflict

retryable: false

409invalid_state_transition

retryable: false

410artifact_expired

retryable: false

429rate_limited

retryable: true

503service_unavailable

retryable: true


تسعير API

يتم تتبع استدعاءات API شهرياً. كل تحويل ناجح يحسب في الحد الشهري للخطة الخاصة بك.

Free

‏0 CA$

25 / month

Starter

‏13.91 CA$ / month

500 / month

Pro

‏82.14 CA$ / year

1,000 / month

Credits

‏6.96 CA$ one-time

250 calls

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

أنشئ عينة PDF premium، ثم قرر هل يستحق API الدمج.

جرّب عينة premium