# من Markdown إلى LaTeX

حوِّل ملاحظات Markdown أو مسودة إلى مستند LaTeX مستقل دون إعادة بناء البنية الأساسية يدويًا.

تتيح أداة من Markdown إلى LaTeX أن تبدأ الفكرة بسيطة ثم تنمو حتى تصبح مستندًا منسّقًا. فتتحول العناوين والنصوص والتوكيدات والقوائم والروابط والأكواد والرياضيات الشائعة إلى ملف `.tex` مستقل يمكنك تجميعه وتحسينه.

## متى تستخدمها

- عندما تكون الملاحظات جاهزة لتتحول إلى ورقة بحثية أو تقرير؛
- عندما كتب أحد المتعاونين المسودة بصيغة Markdown بينما يتوقع مكان النشر LaTeX؛
- عندما تريد نقطة انطلاق نظيفة إلى LaTeX لا قالب دورية منتهيًا.

إذا كانت الوجهة تقبل Markdown فتابع العمل فيها. ويضيف التحويل قيمة عندما تكون الخطوة التالية تخطيطًا خاصًا بـ LaTeX أو مراجع أو حزم أو صنفًا مطلوبًا.

## تحويل المسودة

1. افتح **Markdown to LaTeX**، أو شغِّل `/markdown-to-latex`.
2. الصق مصدر Markdown.
3. اختر **Convert**.
4. راجع نتيجة LaTeX المستقلة.
5. انسخها، أو احفظ `converted.tex`، أو أنشئ مشروع LaTeX.

مصدر Markdown التالي:

```markdown
## Result

The loss fell by **12%**.

$$L(\theta) = \sum_i (y_i - \hat y_i)^2$$
```

يصبح قسمًا ونصًا عريضًا ورياضيات عرض في LaTeX.

## إكمال المستند في LaTeX

يوفر المسار المحلي عبر Pandoc غلافًا عامًا للمستند. وهو لا يختار صنف دورية، ولا يخترع بيانات وصفية للاستشهادات، ولا يعرف الحزم التي يتطلبها القالب النهائي الذي ستستخدمه.

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

أما إذا كانت الوجهة Typst فاستخدم [من Markdown إلى Typst](/docs/tools/markdown-to-typst/) لتجنب تحويل إضافي. ولاستيراد على مستوى المشروع وللصيغ الهدف الأخرى، راجع [استيراد مشروع](/docs/import-project/).
