توثيق API - MD-2-PDF v2.0

نظرة عامة

MD-2-PDF هي أداة لتحويل نصوص Markdown إلى ملفات PDF مع دعم كامل للغة العربية (RTL) والمعادلات الرياضية (LaTeX).

الرابط الأساسي: https://md-2-pdf.pages.dev/api

تنسيق الطلبات: JSON مع Content-Type: application/json

المصادقة

معظم نقاط النهاية تعمل بدون مصادقة. لحفظ السجلات، يمكنك:

• تسجيل الدخول: إرسال JWT token عبر Authorization: Bearer <token>
• ضيف: إرسال معرف الجلسة عبر X-Guest-Session: <id>

المميزات

• ✅ دعم كامل للغة العربية واتجاه RTL
• ✅ معادلات LaTeX الرياضية ($x^2$ و $$\frac{1}{2}$$)
• ✅ تلوين الأكواد البرمجية (Syntax Highlighting)
• ✅ YAML Frontmatter لبيانات المستند
• ✅ صفحة غلاف تلقائية
• ✅ ثيمات متعددة (blue, red, green, purple, gold)
• ✅ أدوات MCP للذكاء الاصطناعي
• ✅ تحويل مزدوج: خادم (Puppeteer) + عميل (html2pdf)

GET /api/health GET

فحص صحة الخادم والتحقق من أنه يعمل.

مثال الطلب

curl https://md-2-pdf.pages.dev/api/health

مثال الاستجابة

{
  "status": "ok",
  "service": "md-2-pdf",
  "version": "2.0.0",
  "timestamp": "2026-01-01T00:00:00.000Z"
}

POST /api/convert POST

تحويل نص Markdown إلى ملف PDF. يعيد PDF بصيغة base64 داخل JSON.

المعاملات

مثال الطلب

curl -X POST https://md-2-pdf.pages.dev/api/convert \
  -H "Content-Type: application/json" \
  -d '{"markdown": "# مرحباً بالعالم\nهذا **نص** تجريبي.\n\nمعادلة: $E = mc^2$", "options": {"title": "مستندي"}}'

مثال الاستجابة

{
  "success": true,
  "message": "Conversion successful",
  "metadata": { "title": "مستندي", "createdAt": "..." },
  "pdf": "JVBERi0xLjQK..."
}

POST /api/parse POST

تحليل Markdown واستخراج البيانات الوصفية مع معاينة HTML.

مثال الطلب

curl -X POST https://md-2-pdf.pages.dev/api/parse \
  -H "Content-Type: application/json" \
  -d '{"markdown": "---\ntitle: مستندي\nauthor: أحمد\n---\n# مرحباً"}'

GET /api/history GET

جلب سجلات المستندات المحفوظة. يتطلب مصادقة (JWT أو Guest Session).

المعاملات (Query)

أدوات MCP المتاحة

خادم MCP يوفر الأدوات التالية للذكاء الاصطناعي:

خادم MCP يعمل محلياً عبر stdio ويحوّل الطلبات تلقائياً إلى https://md-2-pdf.pages.dev/api.

إعداد MCP

إعدادات MCP الجاهزة لكل أداة. انسخ الإعداد المناسب وأضفه لملف إعدادات الأداة.

git clone https://github.com/your-user/md-2-pdf.git
cd md-2-pdf
npm install
npm run build

{
  "mcpServers": {
    "md-2-pdf": {
      "command": "node",
      "args": ["<md-2-pdf-path>/dist/mcp/server.js"]
    }
  }
}

# عبر الأمر
claude mcp add md-2-pdf -- node <md-2-pdf-path>/dist/mcp/server.js

# أو في ملف الإعدادات ~/.config/claude/mcp.json
{
  "mcpServers": {
    "md-2-pdf": {
      "command": "node",
      "args": ["<md-2-pdf-path>/dist/mcp/server.js"]
    }
  }
}

{
  "mcpServers": {
    "md-2-pdf": {
      "command": "node",
      "args": ["<md-2-pdf-path>/dist/mcp/server.js"]
    }
  }
}

{
  "mcp": {
    "md-2-pdf": {
      "type": "stdio",
      "command": "node",
      "args": ["<md-2-pdf-path>/dist/mcp/server.js"]
    }
  }
}

{
  "mcp": {
    "md-2-pdf": {
      "type": "stdio",
      "command": "node",
      "args": ["<md-2-pdf-path>/dist/mcp/server.js"]
    }
  }
}

[mcp_servers.md-2-pdf]
command = "node"
args = ["<md-2-pdf-path>/dist/mcp/server.js"]

{
  "mcpServers": {
    "md-2-pdf": {
      "command": "node",
      "args": ["<md-2-pdf-path>/dist/mcp/server.js"]
    }
  }
}

{
  "command": "node",
  "args": ["<md-2-pdf-path>/dist/mcp/server.js"],
  "transport": "stdio"
}