ForHosting KIT · المستندات وملفات PDF

تحويل Markdown إلى PDF

تتحول ملاحظات الإصدار أو صفحة ويكي أو تقرير كتبه الذكاء الاصطناعي بصيغة Markdown إلى ملف PDF منسق، لا تنقسم فيه الجداول عند حافة الصفحة ولا تبقى العناوين وحيدة في أسفلها. تدفع مقابل كل مستند وكل صفحة دون اشتراك.

● مستقرةلكل طلب · لكل صفحة$0.040

تشغيل — $0.040 + $0.001/صفحة اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

شغّلها أونلاين

شغّل هذه المهمة على خوادمنا باستخدام حسابك. الأدوات المجانية تعمل داخل متصفحك، أما هذه فتُخصم من رصيدك في KIT حسب السعر الموضّح أعلاه.

أداة تحوّل نص Markdown — بعناوينه وقوائمه وجداوله وروابطه وأكواده البرمجية — إلى ملف PDF منسّق جاهز للقراءة أو الطباعة، دون فتح برنامج تنسيق منفصل. تناسب المطوّرين والكتّاب الذين يوثّقون بصيغة Markdown ويحتاجون نسخة نهائية تُرسَل أو تُؤرشَف كمستند واحد قابل للقراءة من أي جهاز.

لماذا يحتاج Markdown إلى خطوة تنسيق حقيقية

انتشر Markdown لأنه سريع الكتابة وسهل المقارنة بين نسخه، لكن قلّة من خارج فرق البرمجة يرغبون في قراءته خامًا. فملاحظات الإصدار وصفحات الويكي الداخلية والتقارير التي يكتبها مساعد ذكي ومقالات قواعد المعرفة تنتهي كلها في بريد شخص ما أو في ملف امتثال، وهناك تحتاج إلى هوامش وأرقام صفحات وتخطيط ثابت. أما نافذة الطباعة في المتصفح فتعطيك لقطة تقريبية للشاشة فقط.

ما الذي يضيفه الترقيم الدقيق للصفحات

تُقرأ العناوين والقوائم والجداول وكتل الشيفرة والاقتباسات كمستند منظم، ثم تُرتب في صفحات وفق قواعد طباعية يتجاهلها المتصفح: تباعد أسطر مريح، وعدم ترك سطر يتيم وحده في أعلى الصفحة أو أسفلها، وفواصل صفحات لا تفصل العنوان عن نصه، وجداول لا تنقسم عند حافة الصفحة. وتحتفظ كتل الشيفرة بخطها ثابت العرض داخل الهوامش، وتحافظ القوائم المتداخلة على إزاحتها. ويمكنك اختيار حجم الورق والاتجاه الأفقي وعنوان يظهر في رأس المستند. والنتيجة ملف PDF واحد مكتفٍ بذاته.

من نص Markdown إلى مستند منسّق

تلصق نص Markdown أو ترفع ملفه، فتحوّله الأداة إلى PDF يترجم كل رمز إلى تنسيقه المقابل: العناوين إلى عناوين بأحجام مختلفة، القوائم إلى نقاط مرقّمة، والجداول إلى جداول حقيقية بحدود واضحة، وكتل الشيفرة إلى فقرات بخط ثابت العرض يسهل تمييزها عن النص العادي. النص العربي داخل الملف يخرج باتجاهه الصحيح من اليمين لليسار دون تدخل يدوي إضافي، حتى عند تداخله مع أسطر شيفرة تُكتب من اليسار لليمين.

لمن يكتب توثيقًا أو ملاحظات تقنية

مطوّر يوثّق واجهة برمجية بصيغة Markdown في مستودع الشيفرة، أو كاتب محتوى يسوّد مقالًا في محرر نصوص بسيط — كلاهما يحتاج أحيانًا نسخة PDF نهائية لمشاركتها مع من لا يصل إلى أدوات المطورين أو لا يفتح ملفات Markdown الخام. تنقل هذه الأداة الملف من صيغته الخام إلى مستند جاهز للقراءة دون فتح برنامج تنسيق منفصل، وتحافظ على الروابط والصور المضمّنة كما وردت في النص الأصلي.

حالات الاستخدام

توثيق برمجي جاهز للمشاركة

يكتب مطوّر في شركة الخليج الرقمية دليل استخدام واجهة برمجية بصيغة Markdown، ثم يحوّله إلى PDF ليرسله لعميل لا يصل إلى مستودع الشيفرة.

ملاحظات اجتماع منظّمة

تدوّن سارة النعيمي ملخص اجتماع فريقها بصيغة Markdown خلال الاجتماع، وتحوّله إلى PDF لأرشفته في مجلد المشروع.

دليل داخلي للموظفين الجدد

تكتب مؤسسة النخيل للمقاولات دليل التعريف بالموظف الجديد كملف Markdown بسيط، ثم تحوّله إلى PDF ليُطبع ويُسلَّم يوم الالتحاق.

الأسئلة الشائعة

هل تدعم الأداة جداول Markdown والعناوين المتداخلة؟

نعم، العناوين بمستوياتها والقوائم النقطية والمرقّمة والجداول كلها تُحوَّل إلى تنسيقها المقابل في ملف PDF.

هل يظهر النص العربي المكتوب داخل ملف Markdown على نحو سليم؟

نعم، يخرج باتجاهه الصحيح من اليمين لليسار، حتى لو كان الملف يخلط بين فقرات عربية وأخرى إنجليزية أو أكواد برمجية.

هل تُحفظ ملفاتي بعد التحويل؟

لا، يُستخدم النص المُرسَل للتحويل فقط ثم يُحذف مع الملف الناتج بعد فترة قصيرة.

هل يعمل من الجوال؟

نعم، يمكن لصق نص Markdown من متصفح الجوال والحصول على الملف مباشرة.

هل تخرج كتل الشيفرة عن هوامش الصفحة؟

لا. تحتفظ كتل الشيفرة بخطها ثابت العرض وتبقى داخل الهوامش فلا تتجاوز حافة الورقة، كما تحافظ القوائم المتداخلة على إزاحتها كما كتبتها في الأصل.

أدوات ذات صلة

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/pdf/from-markdown

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/pdf/from-markdown \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"markdown":"# Informe\n\nPrimer párrafo."}'

const res = await fetch("https://api.kit.forhosting.com/pdf/from-markdown", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "markdown": "# Informe\n\nPrimer párrafo."
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/from-markdown",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "markdown": "# Informe\n\nPrimer párrafo."
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/from-markdown", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"markdown":"# Informe\\n\\nPrimer párrafo."}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"markdown":"# Informe\n\nPrimer párrafo."}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/from-markdown", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "markdown": "# Informe\n\nPrimer párrafo."
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.from_markdown",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.040

لكل صفحة$0.001

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

`max_mb`	25
`max_pages`	200

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.
`413`	`input_too_large`	حجم المدخلات يتجاوز الحد المسموح لهذه المهمة — قسّم الملف أو صغّره.
`422`	`task_failed`	لم تنجح معالجة المهمة، ولن تُحتسب عليك؛ أعد المحاولة أو راسلنا مباشرة.

ملاحظات تقنية

سعر يبدأ من $0.040 وحد أقصى معقول

يبدأ الطلب من $0.040 وتُضاف $0.001 عن كل صفحة بعد الأولى، حتى 200 صفحة و25 MB للناتج، ويظهر السعر الإجمالي قبل تأكيد التحويل فلا حاجة لتخمين التكلفة مسبقًا. الاستخدام من هذه الصفحة مباشرة، ومتاح أيضًا عبر الـAPI لمن يولّد ملفات PDF تلقائيًا من ملفات Markdown في مشروع برمجي، مثل توليد تقرير إصدار جديد من ملف تغييرات المشروع كل أسبوع دون تدخل بشري في كل مرة.

أسئلة تقنية

ما تكلفة تحويل ملف من خمس صفحات؟

$0.040 للطلب زائد $0.001 عن كل صفحة بعد الأولى، أي نحو $0.044 لخمس صفحات.

هل يمكن استخدام الأداة من داخل مشروع برمجي لتوليد الملفات تلقائيًا؟

نعم، عبر الـAPI يمكن إرسال نص Markdown مباشرة والحصول على ملف PDF دون فتح هذه الصفحة يدويًا.

اطّلع على توثيق KIT الكامل ←