أداة ترجمة ملفات التوثيق بصيغة Markdown
ترجمة توثيق Markdown وMDX مع الحفاظ التام على الأكواد والروابط
ارفع ملفات .md أو .mdx، أو مجلد التوثيق كاملاً بصيغة .zip، واختر اللغة، لتستلم المجلد نفسه مترجماً. تبقى كتل الأكواد البرمجية، والتعليمات البرمجية المضمنة، وعناوين الروابط والصور، ومفاتيح front matter، واستدعاءات MDX ومكوناتها كما كُتبت تماماً؛ بينما تُترجم العناوين والفقرات والقوائم والجداول والنصوص البديلة للصور وعناوين وأوصاف front matter. الجزء الأول مجاني بدون تسجيل؛ ومجلد التوثيق كاملاً حتى 1,000,000 حرف مقابل $5 كدفعة واحدة. يمكن لأي روبوت دردشة ترجمة ملف README واحد، لكن موقع توثيق يضم خمسين ملفاً ينتهي به الأمر عادةً بأكواد برمجية مترجمة وروابط معطلة وتعديلات عشوائية في front matter.
- حتى 40 فقرة مجاناً بالكامل؛ والمهام الأكبر يبدأ فيها الجزء الأول مجاناً
- المهمة كاملة مقابل $5: مجلد توثيق (.zip) أو حتى 50 ملفاً، بما يصل إلى 1,000,000 حرف
- لا تُترجم الكتل البرمجية، والأكواد المضمنة، والروابط، ومفاتيح front matter، ومكونات MDX مطلقاً
- استعادة هيكل المجلدات نفسه بصيغة .zip؛ مع نسخ الصور وملفات الإعدادات كما هي
- متوافق مع Docusaurus وMkDocs وHugo وAstro وVitePress وNext.js وملفات README على GitHub
- 81 لغة، مع مسرد للمصطلحات وأسماء المنتجات التي ترغب في الحفاظ عليها
ما ستحصل عليه
يُعاد الملف الفردي مضافاً إليه رمز اللغة في اسمه (يتحول README.md إلى README.de.md مثلاً). أما المجلد فيُعاد بصيغة .zip بالمسارات نفسها داخل مجلد يحمل اسم اللغة، مثل docs-de/، وجاهز للنسخ إلى مسار i18n/de أو مجلد اللغات في موقعك. قبل التنزيل، يُعرض كل جزء نصي بتنسيق Markdown على الشاشة بجانب النص الأصلي، ويمكنك تعديله مباشرة.
- تحتفظ العناوين بمعرّفاتها، مثل {#install}؛ وتظل علامات القوائم ومسافاتها البادئة كما هي؛ كما تحافظ الجداول على فواصل أعمدتها وصفوف المحاذاة.
- الروابط: يُترجم نص الرابط ويبقى العنوان والرابط الأصلي دون تغيير؛ ولا تُمس التعريفات المرجعية مثل [docs]: https://… على الإطلاق.
- حقول front matter: تُترجم الحقول النصية مثل title وdescription وsummary وsidebar_label وما يماثلها؛ بينما تبقى الروابط المختصرة (slugs) والتواريخ والوسوم والمعرفات (ids) وكافة المفاتيح الأخرى كما هي.
- تنسيق MDX: تُنسخ أسطر import وexport وأسطر مكونات JSX والتعبيرات {expressions} كما هي تماماً.
ترجمة التوثيق باستخدام روبوت الدردشة مقابل هذه الأداة
تترجم روبوتات الدردشة ملف README واحداً بشكل جيد في أغلب الأحيان. لكن مواقع التوثيق تتكون من ملفات عديدة تعج بصيغ وقواعد برمجية لا يجب المساس بها، ولا توجد آلية تراجع ما يُفسده روبوت الدردشة أثناء إعادة الصياغة.
| الحالة | روبوت الدردشة | هذه الأداة |
|---|---|---|
| ملف README قصير واحد | يترجمه جيداً في الغالب | يترجمه مع الحفاظ الدقيق على تنسيق Markdown |
| مجلد توثيق يحتوي على 60 ملفاً | ملف تلو الآخر يدوياً؛ وتتوقف الملفات الطويلة في المنتصف | ملف .zip كاملاً في مهمة واحدة، وتُستعاد المسارات نفسها |
| الكتل البرمجية والأكواد المضمنة | يترجم أحياناً التعليقات التوضيحية أو أسماء المتغيرات أو الأوامر البرمجية | لا تُرسل للترجمة إطلاقاً؛ وتُنسخ بالبايت تماماً كما هي |
| الروابط والصور | قد يترجم المسارات ومعرفات الربط أو يعيد صياغتها | تُحجب العناوين والمسارات عن النموذج البرمجي وتُعاد دون أدنى تغيير |
| بيانات front matter | قد يترجم مفاتيح مثل slug أو id | تُترجم الحقول النصية فقط مثل title وdescription |
| مكونات MDX | قد يغير صياغة JSX أو الخصائص (props) | تُترك أسطر import وexport والمكونات كما كُتبت تماماً |
كيفية ترجمة مجلد توثيق بصيغة Markdown
-
1
ارفع الملفات أو ملف .zip واختر اللغة
أفلت ملفات .md أو .mdx أو .markdown، أو اضغط مجلد التوثيق وأفلت ملف .zip. اختر اللغة، وحدد أسماء المنتجات والمصطلحات التي ترغب في الحفاظ عليها.
-
2
عاين الجزء الأول مجاناً
تظهر الأجزاء الأولى من النص على الشاشة بجانب النص الأصلي. يمكنك تعديل أي منها، ولا يلزم إنشاء حساب.
-
3
افتح النتيجة كاملة ونزّلها
افتح النتيجة كاملة للمهمة مقابل $5 ونزّل المجلد المترجم بصيغة .zip، بالإضافة إلى قائمة تنبيهات إذا كان هناك ما يتطلب المراجعة.
لماذا تفشل روبوتات الذكاء الاصطناعي العامة في ترجمة التوثيق؟
يمزج Markdown بين النصوص النثرية وعناصر أخرى ليست نثراً: كالأكواد، والأوامر البرمجية، والمسارات، ومعرفات الربط، ومفاتيح YAML، وJavaScript في MDX. عندما يعيد روبوت الدردشة كتابة الملف كاملاً، يتوجب عليه نسخ كل هذه التفاصيل بدقة متناهية بالتزامن مع ترجمة الكلمات المحيطة بها في كل ملف على حدة، دون أن ينبهك أحد إذا ما تُرجم أمر برمجي أو عُدّل مسار رابط عن طريق الخطأ.
تقرأ هذه الأداة كل ملف سطراً بسطر، وتتخطى كتل الأكواد البرمجية وأسطر استدعاء MDX وأسطر المكونات تماماً، وتستبدل الأكواد المضمنة وعناوين الروابط ومسارات الصور والتعبيرات {expressions} بعلامات استبدال قصيرة قبل إرسال أي شيء إلى النموذج. وتُترجم العناوين والفقرات وعناصر القوائم وخلايا الجداول والنصوص البديلة للصور وحقول front matter النصية فقط، وذلك في كتل نصية مصحوبة باسم الملف كسياق، مع اشتراط استعادة كل علامة استبدال في مكانها. ثم يُعاد بناء الملف اعتماداً على الأسطر الأصلية.
أبرز ما يترجمه المستخدمون
- مواقع التوثيق المبنية بواسطة Docusaurus وVitePress وMkDocs وHugo وAstro
- ملفات README وإرشادات المساهمة CONTRIBUTING وموسوعات wiki المصدرة من GitHub بصيغة Markdown
- ملاحظات Obsidian أو Notion المصدرة إلى Markdown
- مقالات المدونات وقواعد المعرفة المحفوظة كملفات .md
- المواد التعليمية والكتب المكتوبة بصيغة Markdown
حدود تجدر معرفتها
تُترجم الحقول النصية فقط في front matter (مثل title وdescription وsummary وexcerpt وsidebar_label وما شابهها)؛ بينما تُترك قيم YAML متعددة الأسطر والقوائم كما هي. تُترجم كتل HTML المباشرة مع الحفاظ على وسومها البرمجية. ولا تُترجم التعليقات التوضيحية داخل الكود البرمجي عمداً لحمايته. أما الملفات الأخرى غير ملفات Markdown الموجودة داخل ملف .zip فتُنسخ دون تعديل.
تغطي الدفعة الواحدة ما يصل إلى 1,000,000 حرف من النص، أي حوالي 300 صفحة، داخل ملف .zip أو ما يصل إلى 50 ملفاً؛ بينما تغطي باقة غير محدود حتى 2,000,000 حرف. احرص على مراجعة النتيجة قبل النشر، ولا سيما مصطلحات المنتجات؛ حيث يساعدك المسرد في الحفاظ على اتساقها.
حسب اللغة والحالة
ترجمة مجلد وثائق Docusaurus
اضغط مجلد docs في ملف ZIP وارفعه، وستستلمه مترجماً بالملفات نفسها، ليكون جاهزاً لوضعه مباشرة في i18n/<locale>/...
اقرأ المزيد →ترجمة ملف README إلى الصينية
ارفع ملف README.md، أو مجلد docs بأكمله في ملف zip.، وستستلمه بالصينية المبسطة أو التقليدية بتنسيق Markdown سل...
اقرأ المزيد →ترجمة ملفات MDX
ارفع ملفات .mdx أو مجلد محتوى مضغوطًا بصيغة .zip، وستحصل عليها مترجمة مع الحفاظ على كل سطر استيراد وتصدير، وكل...
اقرأ المزيد →الأسعار
المهام الصغيرة، والجزء الأول
مجاناً
حتى 40 فقرة مجاناً بالكامل شاملة التنزيل. المهام الأكبر يُعرض الجزء الأول منها مجاناً، دون الحاجة إلى حساب.
المهمة كاملة
$5
دفعة واحدة لمجلد توثيق أو ما يصل إلى 50 ملفاً، بما يصل إلى 1,000,000 حرف. بدون اشتراك.
غير محدود
$19 / أسبوع
جميع الأدوات على الموقع، مع مهام تصل إلى 2,000,000 حرف.
أسئلة وأجوبة
هل يستطيع ChatGPT ترجمة ملفات Markdown دون إفساد تنسيقها؟
بالنسبة لملف واحد قصير، يمكنه ذلك عادةً. لكن عند معالجة مجلد مستندات كامل، يصبح الأمر بطيئاً، وتتوقف الملفات الطويلة في المنتصف، ولا توجد آلية تضمن سلامة الأكواد والروابط ومفاتيح front matter. لا تُرسل هذه الأداة الأكواد أو العناوين للترجمة أبداً، وتُعيد بناء كل ملف انطلاقاً من ملفك الأصلي.
هل تُترجَم كتل الأكواد البرمجية؟
لا. تُنسخ كتل الأكواد المحددة والأسطر البرمجية المضمنة والأكواد ذات المسافات البادئة كما هي تماماً، بما في ذلك التعليقات البرمجية بداخلها.
هل تعمل الأداة مع MDX؟
نعم. تُترك أسطر الاستيراد والتصدير، والأسطر المقتصرة على مكونات JSX، وتعبيرات {expressions} كما هي تماماً دون تغيير؛ بينما تُترجم النصوص العادية الواقعة بينها.
ماذا يحدث لبيانات front matter؟
تُترجم الحقول النصية مثل title وdescription وsummary وsidebar_label. بينما تبقى المفاتيح والروابط الدائمة (slugs) والتواريخ والوسوم والمعرّفات (ids) وسائر القيم الأخرى كما كُتبت.
هل يمكنني رفع مجلد كامل؟
نعم. اضغط المجلد في ملف .zip وارفعه. ستحصل على النتيجة كملف .zip يحمل المسارات نفسها داخل مجلد يحمل اسم اللغة؛ وتُنسخ الصور وسائر الملفات دون أي تعديل.
ما الحجم الذي يمكنني ترجمته مقابل $5؟
ما يصل إلى 1,000,000 حرفاً من النص، أي حوالي 300 صفحة، في مهمة واحدة: ملف .zip أو ما يصل إلى 50 ملفات بحجم يصل إلى 100 ميغابايت. ولا تُحتسب الأكواد البرمجية ومفاتيح front matter ضمن ذلك.
هل الأداة مجانية؟
الجزء الأول من كل مهمة يُترجم مجاناً ويُعرض على الشاشة. والمهمة التي تحتوي على ما يصل إلى 40 فقرة تكون مجانية بالكامل، شاملاً التنزيل. أما المهام الأكبر فتبلغ $5، دفعة واحدة.
هل ملفاتي محمية وتتمتع بالخصوصية؟
أنت وحدك من يمكنه فتح مهمتك. يُرسل النص إلى مزود نموذج الذكاء الاصطناعي لغرض الترجمة فقط ولا يُستخدم في التدريب. تُحذف المهام المرفوعة بدون تسجيل بعد 7 يوماً، ويمكنك حذف أي مهمة بنفسك في أي وقت.
حُدّث 25 أكتوبر 2026 · APPFACT STUDIO LTD