Markdown Converter API للمطورين
حوِّل ملفات Markdown وPDF وWord وHTML برمجيًا عبر نقطة نهاية REST واحدة. دعم كامل لمعادلات LaTeX ومخططات Mermaid، مستضافة وجاهزة للاستدعاء من أي لغة برمجة. احصل على مفتاح API من RapidAPI وابدأ التحويل في دقائق.
دليل البدء السريع مع Markdown Conversion API
طلبان فقط: أرسل ملفًا للحصول على معرّف المهمة، ثم استعلم عنه للحصول على رابط التنزيل. جميع نقاط النهاية تتبع نفس النمط.
# 1. Submit a Markdown file for PDF conversion
curl -X POST "https://markdown-converter-pro.p.rapidapi.com/apix/md-to-pdf" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: markdown-converter-pro.p.rapidapi.com" \
-F "source_file=@README.md"
# -> { "task_id": "550e8400-...", "status": "processing" }
# 2. Poll for the result until status is "completed"
curl -X POST "https://markdown-converter-pro.p.rapidapi.com/apix/query-task" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: markdown-converter-pro.p.rapidapi.com" \
-d "task_id=550e8400-..."
# -> { "status": "completed", "to_url": "https://.../README.pdf" }1. إرسال طلب التحويل
أرسل ملفًا مرفوعًا (source_file) أو رابطًا عامًا للملف (source_file_url)، وستحصل على task_id.
2. الاستعلام عن النتيجة
استعلم عبر query-task مُمرِّرًا task_id حتى يصبح الحالة completed، ثم نزِّل الملف من to_url.
نقاط نهاية API لتحويل Markdown إلى PDF وWord وHTML
جميع نقاط النهاية تقبل POST بصيغة multipart/form-data وتُعيد task_id. المسار الأساسي: /apix.
| الأسلوب | نقطة النهاية | الوصف | أداة عبر الإنترنت |
|---|---|---|---|
| POST | /apix/md-to-pdf | تحويل Markdown إلى PDF مع تصيير معادلات LaTeX ومخططات Mermaid. | جرّب عبر الإنترنت |
| POST | /apix/md-to-docx | تحويل Markdown إلى مستند Word قابل للتحرير (.docx). | جرّب عبر الإنترنت |
| POST | /apix/md-to-html | تحويل Markdown إلى HTML نظيف ودلالي. | جرّب عبر الإنترنت |
| POST | /apix/pdf-to-md | استخراج Markdown من ملف PDF، بما يشمل النصوص والجداول والصور. | جرّب عبر الإنترنت |
| POST | /apix/docx-to-md | تحويل مستند Word (.docx) إلى Markdown. | جرّب عبر الإنترنت |
| POST | /apix/html-to-md | تحويل صفحة HTML أو جزء منها إلى Markdown نظيف. | جرّب عبر الإنترنت |
| POST | /apix/query-task | الاستعلام عن مهمة بواسطة task_id واسترجاع رابط التنزيل عند الاكتمال. | — |
كيف يعمل Async Conversion API
تعمل عمليات التحويل بشكل غير متزامن، فلا تُوقِف الملفات الكبيرة طلباتك أبدًا.
الإرسال
أرسل ملف Markdown أو PDF أو Word أو HTML — رفعًا مباشرًا أو عبر رابط عام — إلى نقطة النهاية المناسبة.
استلام معرّف المهمة
تُعيد الـ API فورًا task_id بحالة processing، دون إبقاء الاتصال مفتوحًا.
الاستعلام والتنزيل
استدعِ query-task مُمرِّرًا task_id. حين تصبح الحالة completed، نزِّل الملف من to_url الوارد في الاستجابة.
ما الذي يُصيِّره Markdown Converter API
من معادلات LaTeX إلى مخططات Mermaid، تحوِّل الـ API كود Markdown المعقد إلى PDF وWord وHTML بدقة كاملة دون أي فقدان للمحتوى.
معادلات LaTeX الرياضية
تُصيَّر معادلات LaTeX المضمنة والكتلية بدقة في مخرجات PDF وWord — مثالية للوثائق الأكاديمية والتقنية.
مخططات Mermaid
تُحوَّل مخططات التدفق والتسلسل وGantt ومخططات الكلاسات المكتوبة بـ Mermaid إلى رسومات حقيقية.
دعم كامل لـ GFM
الجداول والقوائم المهامية وكتل الكود المُسيَّجة مع إبراز بناء الجملة، والنص المشطوب، والروابط التلقائية — كلها محفوظة.
تحويل ثنائي الاتجاه
حوِّل من Markdown إلى PDF وWord وHTML، أو عكس هذه التنسيقات إلى Markdown نظيف لأغراض إدارة الإصدارات.
حالات استخدام Markdown Conversion API
يستخدم المطورون الـ API لتوليد المستندات تلقائيًا — في سلاسل البناء، وميزات المنتجات، والمعالجة الجماعية.
سلاسل CI/CD
أنشئ ملاحظات الإصدار والتقارير ومخرجات PDF من Markdown مع كل بناء، دون الحاجة إلى صيانة متصفح headless.
أدوات إنتاج التوثيق
حوِّل ملفات التوثيق المكتوبة بـ Markdown إلى PDF أو Word قابلَين للتنزيل للمستخدمين والعملاء والقراءة دون اتصال — تلقائيًا.
التحويل الجماعي
عالج مجموعات كبيرة من المستندات على جانب الخادم بتمرير روابط الملفات العامة، ثم اجمع النتائج بواسطة معرّف المهمة.
أسعار Markdown Converter API
تُدار فوترة الـ API عبر RapidAPI بمستوى مجاني للبدء وخطط مدفوعة تتناسب مع حجم استخدامك. تُدار الفوترة والمفاتيح وحدود معدل الطلبات من حساب RapidAPI الخاص بك.
Basic
30
طلب / شهر
Pro
800
طلب / شهر
+ $0.02 / request
Ultra
4,000
طلب / شهر
+ $0.012 / request
Mega
12,000
طلب / شهر
+ $0.008 / request
الحصص والأسعار محددة على RapidAPI وقابلة للتغيير — راجع الخطط الحية للاطلاع على التفاصيل الحالية.
عرض الخطط على RapidAPIالأسئلة الشائعة حول تكامل Markdown API
كل ما يحتاجه المطور للمرة الأولى للاشتراك والمصادقة وإرسال الطلبات واختيار الخطة المناسبة لـ Markdown conversion API.
كيف أبدأ استخدام Markdown conversion API؟
أنشئ حسابًا مجانيًا على RapidAPI، افتح Markdown Converter Pro API في RapidAPI Hub، واشترك في إحدى الخطط — خطة Basic مجانية. بمجرد الاشتراك، يمكنك استدعاء أي نقطة نهاية فورًا باستخدام أمثلة الكود أعلاه.
أين أجد مفتاح API الخاص بي؟
بعد الاشتراك، يُصدر RapidAPI مفتاح API شخصيًا لحسابك. ستجده في لوحة تحكم RapidAPI وفي تبويب Code Snippets لأي نقطة نهاية. أرسله مع كل طلب كترويسة X-RapidAPI-Key، إلى جانب ترويسة X-RapidAPI-Host الظاهرة بجانبه.
ما أنواع التحويل التي تدعمها الـ API؟
تمتلك الـ API ست نقاط نهاية للتحويل — من Markdown إلى PDF وWord وHTML، وعكسها من PDF وWord وHTML إلى Markdown — إضافةً إلى نقطة نهاية query-task لاسترجاع النتائج. يُدرج جدول نقاط النهاية أعلاه المسار الدقيق لكل واحدة.
ما المعاملات التي يتطلبها طلب التحويل؟
تقبل كل نقطة نهاية طلب multipart/form-data يحتوي على أحد حقلين: source_file لرفع الملف مباشرةً، أو source_file_url للإشارة إلى ملف متاح للعموم. استخدم أحدهما فقط — إذا أُرسل كلاهما، فإن source_file يأخذ الأولوية. يمكن أن تصل الملفات إلى 50 MB، ويجب أن يتطابق نوع الملف مع نقطة النهاية، فـ md-to-pdf يتوقع ملفًا بامتداد .md.
كيف أحصل على الملف المُحوَّل؟
تعمل عمليات التحويل بشكل غير متزامن، لذا يُعيد الطلب الناجح task_id بدلًا من الملف مباشرةً. مرِّر هذا task_id إلى نقطة نهاية query-task واستمر في الاستعلام حتى تصبح الحالة completed، ثم نزِّل الملف الجاهز من to_url في الاستجابة.
ماذا يحدث عند فشل عملية التحويل؟
إذا تعذَّر إتمام التحويل، تُعيد query-task حالة failed بدلًا من completed. الأسباب الشائعة هي: نوع ملف لا يتطابق مع نقطة النهاية، أو source_file_url غير متاح للعموم، أو ملف يتجاوز 50 MB. صحِّح المدخلات وأعد إرسال الطلب.
أي خطة تسعير يجب أن أختار؟
ابدأ بخطة Basic المجانية لاختبار تكاملك، ثم انتقل إلى خطة مدفوعة مع نمو حجم طلباتك الشهرية. تتضمن كل خطة حصة شهرية من الطلبات وتفرض سعرًا بسيطًا لكل طلب يتجاوزها — يعرض جدول الأسعار أعلاه المستويات الحالية. تُدار الفوترة والحدود من حساب RapidAPI الخاص بك.
ماذا يحدث لملفاتي بعد التحويل؟
لا تُحتفظ بملفاتك. تُعالَج المستندات المرفوعة والمخرجات المُحوَّلة بصورة مؤقتة وتُحذف بعد ذلك، وتُقدَّم الملفات الجاهزة من رابط تنزيل قصير الأمد بدلًا من تخزينها على المدى البعيد.
ابدأ التحويل في دقائق
اشترك على RapidAPI، احصل على مفتاحك، وأجرِ أول طلب تحويل اليوم.
ابدأ الآن على RapidAPI