ترجمة ملفات Markdown
تترجم هذه الأداة نص ملف Markdown من لغة إلى أخرى، فتنقل الجمل والفقرات إلى اللغة الهدف وتترك رموز التنسيق ذاتها — علامات العناوين والروابط والقوائم والتأكيد — كما هي دون تغيير، فيخرج ملف يعرض بنفس الشكل عند تحويله إلى صفحة أو مستند.
شغّلها أونلاين
شغّل هذه المهمة على خوادمنا باستخدام حسابك. الأدوات المجانية تعمل داخل متصفحك، أما هذه فتُخصم من رصيدك في KIT حسب السعر الموضّح أعلاه.
رموز Markdown تبقى كما هي
علامات التنسيق في Markdown — النجوم حول الكلمة المؤكدة، الشباك قبل العنوان، الأقواس والحاصرات حول الرابط — ليست جزءًا من النص المقروء بل تعليمات تنسيق يفهمها أي محوّل Markdown. تميّز الأداة هذه الرموز عن النص الفعلي، فتترجم الكلمات وتترك الرموز في مكانها، فيبقى الملف الناتج قابلًا للتحويل إلى صفحة HTML أو مستند بنفس شكل التنسيق الأصلي دون أي كسر.
الروابط وكتل الكود
روابط Markdown تحوي نصًا ظاهرًا للقارئ وعنوانًا فعليًا بينهما؛ تترجم الأداة النص الظاهر فقط وتترك العنوان الفعلي كما هو حتى يظل الرابط يعمل. كتل الكود المحاطة بثلاث علامات اقتباس عكسية تبقى كما هي بالكامل دون أي ترجمة، لأنها غالبًا شيفرة برمجية أو أوامر طرفية لا نصًا موجهًا للقارئ.
الجداول والقوائم المرقمة
جداول Markdown المبنية بخطوط وأنابيب، والقوائم المرقمة أو النقطية، تحافظ على بنيتها كاملة بعد الترجمة: عدد الأعمدة، ترتيب الصفوف، ترقيم العناصر. يُترجَم محتوى كل خانة أو عنصر فقط، فيخرج الجدول أو القائمة بنفس الشكل الذي بُني عليه قبل الترجمة، جاهزًا للعرض مباشرة.
السعر
$0.003 للطلب و$0.0135 لكل ألف كلمة من النص المترجَم، بصرف النظر عن عدد رموز التنسيق المحيطة به. تعمل من صفحة الأداة، ومتاحة عبر الـAPI لترجمة توثيق تقني كامل مكوّن من عشرات ملفات Markdown دفعة واحدة.
حالات الاستخدام
توثيق مشروع مفتوح المصدر
يترجم عبدالله المنصوري ملف README بصيغة Markdown لمشروع برمجي فتحه للمساهمة العامة، من العربية إلى الإنجليزية، محافظًا على كتل الكود وروابط التثبيت كما هي.
مدونة تقنية بصيغة Markdown
تكتب فاطمة الزهراني مقالاتها التقنية بصيغة Markdown قبل نشرها، وتترجمها إلى الإنجليزية دون إعادة كتابة عناوين الأقسام والروابط الداخلية يدويًا.
دليل مستخدم داخلي
يحوّل قسم التدريب في شركة الخليج الرقمية دليل مستخدم داخلي مكتوبًا بـMarkdown إلى الإنجليزية لموظفين جدد من خارج المنطقة.
الأسئلة الشائعة
هل تُترجَم النصوص داخل كتل الكود؟
لا، كتل الكود المحاطة بثلاث علامات اقتباس عكسية تبقى كما هي كاملة دون أي ترجمة، لأنها شيفرة برمجية لا نص لغوي.
ماذا يحدث لعنوان الرابط الفعلي بعد الترجمة؟
يبقى كما هو؛ يُترجَم فقط النص الظاهر للقارئ بين الحاصرتين، أما العنوان الفعلي بين القوسين فيبقى دون تغيير حتى يستمر الرابط في العمل.
هل تحافظ الأداة على ترقيم القوائم؟
نعم، ترقيم القوائم وبنية الجداول تبقى كما هي؛ تُترجَم محتويات كل عنصر أو خانة فقط دون المساس بالترتيب.
كم تكلفة ترجمة ملف توثيق من ثلاثة آلاف كلمة؟
$0.003 للطلب و$0.0135 لكل ألف كلمة، أي نحو $0.0435 إجمالًا لملف من ثلاثة آلاف كلمة.
هل تصلح لترجمة عشرات الملفات دفعة واحدة؟
عبر الـAPI نعم، يمكن إرسال كل ملف Markdown كطلب مستقل ضمن مسار معالجة دفعية لتوثيق كامل.
هل تُحفظ الملفات المرسلة بعد الترجمة؟
لا، يُستخدم الملف لإنتاج النسخة المترجمة فقط ثم يُستبعد دون حفظ نسخة منه بعد اكتمال الطلب.
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/translate/markdown \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"…"}'const res = await fetch("https://api.kit.forhosting.com/translate/markdown", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/translate/markdown",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/translate/markdown", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/translate/markdown", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"text": "…"
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "translate.markdown",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الحدود
max_tokens | 20000 |
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
422 | task_failed | لم تنجح معالجة المهمة، ولن تُحتسب عليك؛ أعد المحاولة أو راسلنا مباشرة. |