> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/ar/mqalat-mtamqh/32-markdown-into-latex-with-style.md). # تحويل Markdown إلى LaTeX بأسلوب جميل **تحديث ما بعد النشر** (13 مايو 2017): نحن ممتنون لفِيت نوفوتني، المؤلف/المُشرف على `markdown` الحزمة، لكتابته إلينا ببعض الملاحظات المفيدة بشأن المقال الأصلي. ويسعدنا نشر هذه النسخة المحدَّثة التي تأخذ بنصيحته واقتراحاته في الاعتبار وتتضمنها. ### مقدمة قبل فترة قصيرة ابتهجنا بإصدار [`حزمة markdown`](http://www.ctan.org/pkg/markdown) التي جعلت من الممكن كتابة صياغة markdown في مستندات LaTeX — واحتفلنا بذلك بمقال بعنوان [كيفية الكتابة بصيغة Markdown على Overleaf](/latex/ar/mqalat-mtamqh/30-how-to-write-in-markdown-on-overleaf.md) كان الغرض منه عرض بعض الصيغ المدعومة. **تذكّر**: ستحتاج إلى تجميع `.tex` ملفاتك باستخدام `--shell-escape` الخيار ليعمل ذلك على تثبيتات LaTeX المحلية — يقوم Overleaf بذلك تلقائيًا. ضع في اعتبارك أن معظم بوابات تقديم المجلات لا تفعّل `--shell-escape`—إلا إذا كان مسموحًا لك بتحميل ملف PDF الناتج فقط من مخطوطتك، فقد لا تُجمَّع ملفات LaTeX التي تحتوي على markdown بنجاح عند معالجتها بواسطة نظام التقديم الخاص بالناشر. إحدى الأفكار المشار إليها في [المقال السابق](/latex/ar/mqalat-mtamqh/30-how-to-write-in-markdown-on-overleaf.md) هي أن الجمع بين markdown وLaTeX يتيح فصلًا رائعًا بين المحتوى والأسلوب. وسيكون لدى المؤلفين (وخاصة أولئك الملمّين بالفعل بـmarkdown) صياغة أكثر إيجازًا للعمل بها (مع بعض التحفظات) مع الاحتفاظ بإمكانية الوصول إلى جميع مزايا حزم وقوالب LaTeX لتولي التنسيق والإخراج. ذلك [المقال السابق](/latex/ar/mqalat-mtamqh/30-how-to-write-in-markdown-on-overleaf.md) قدّم بعض الأمثلة على استخدام markdown في [عروض Beamer التقديمية](https://www.overleaf.com/read/dnrwnjrpjjhw) و [الملصقات](https://www.overleaf.com/read/jtbgmmgqrqmh): اليوم سنلقي نظرة على المزيد من إمكانات التنسيق الممتعة والمثيرة! ### استخدام markdown في قوالب LaTeX المنسقة إلى جانب الأمثلة أعلاه، يمكنك استخدام markdown في معظم القوالب تقريبًا. إليك بضعة أمثلة سريعة: * ال [كتاب Legrange البرتقالي](https://www.overleaf.com/latex/templates/the-legrand-orange-book-template-english/jtctyfmnpppc) نموذج * ال [مطبوعة مستوحاة من Tufte](https://www.overleaf.com/latex/templates/handout-design-inspired-by-edward-tufte/dtsbhhkvghzz) نموذج * هذا [قالب مقال جميل جدًا](https://www.overleaf.com/read/xfsrpsmdtqvt) بواسطة Thiago قد تلاحظ أن اثنين من هذه قوالب مقالات وواحد منها قالب كتاب. إن [`حزمة markdown`](http://www.ctan.org/pkg/markdown) تكتشف ما إذا كانت `\chapter` الأمر متاحًا للاستخدام في مستند LaTeX معيّن وستجعل العنوان من المستوى الأول `markdown` يُعرض على هيئة `\chapter` أو `\section` بما يتناسب. ### مطويات سريعة جدًا: markdown + pocketmod منذ أن تعرّفت لأول مرة على markdown، بدا لي طريقة سريعة ومريحة لتدوين الملاحظات: فهو يعكس كيف يمكنني أن أخربش الملاحظات على قصاصات الورق أو أوراق الملاحظات اللاصقة — خصوصًا مع صياغة القوائم المنقطة والمرقمة. عندما أنشأت لأول مرة [قالب PocketMod](https://www.overleaf.com/read/nqbhpnrkskrx) في عام 2015، كنت أتطلع إلى طريقة لكتابة markdown في LaTeX حتى أتمكن من إنشاء PocketMods *مع* markdown لأنه بدا... مناسبًا. تدوين الملاحظات بصياغة بسيطة على كتيبات صغيرة مطوية، ولكن بطباعة جميلة — يشير بعض الناس إلى PocketMods بوصفها "zines" لأنها كتيبات صغيرة من 8 صفحات يمكنك صنعها من ورقة A4 واحدة. وهكذا كان ذلك ممكنًا فعلًا! وهذا يجعل من السهل إلى حدّ ما إنتاج [كتيب مخطط أسبوعي صغير](https://www.overleaf.com/read/zfzcxygqwqsq) أو [كتاب قصص مصوّرة](https://www.overleaf.com/read/rppnsfgnrhsf). نعم، استمتعَت ابنتي برؤية كتاب قصصي مصنوع من رسوماتها الخاصة… حسنًا، لمدة 10 دقائق فقط! إن [`حزمة markdown`](http://www.ctan.org/pkg/markdown) يتيح لك تخصيص كيفية تحويل كل صيغة markdown إلى LaTeX، لذا أعدتُ تعريف الصيغة القياسية `![](img_file "caption")` لوضع التسمية التوضيحية أسفل ملف الصورة (من دون أي بادئة "Figure" أو ترقيم)، ثم أدخلت فاصل صفحة. وهذا يجعل إنشاء كتاب الصور أسهل أيضًا. إليك فيديو يوضح كيفية طي الكتيب: {% embed url="" %} ### كتيبات وصفات بسيطة عندما تفكر في الأمر، تتألف الوصفة من قوائم: قائمة بالمكونات، وقائمة بتعليمات التحضير أو الطبخ، وربما قائمة بالملاحظات (وقت الطهي، عدد الحصص، إلخ). لذا بدلًا من كتابة هذا: ```latex \begin{enumerate} \item افعل هذا أولًا \item ثم افعل ذلك ... \end{enumerate} ``` كنت سأقدّر بالتأكيد القدرة على كتابة هذا: ``` #. افعل هذا أولًا #. ثم افعل ذلك ``` وكذلك بالنسبة إلى المكونات: ``` - بيضتان - رشة ملح ``` لذا، لإنتاج وصفة سريعة بسهولة يمكننا كتابة هذا: ``` # البيض المخفوق وقت الطهي : 5 دقائق يكفي : 1 ## المكونات - 4 بيضات - 1 ملعقة صغيرة زبدة - 1/4 كوب حليب - ملح، فلفل (حسب الذوق) ## التعليمات #. اخفق البيض، والحليب... #. سخّن الزبدة في المقلاة... #. ... ``` همم، يبدو ذلك واعدًا. ساهم عددٌ منا في Overleaf (وعائلاتنا) بوصفاتنا السريعة المفضلة (وهي مثالية للطهاة المبتدئين)، وقمتُ بإعداد — معذرة على التلاعب اللفظي — [قالب وصفة سريعة](https://www.overleaf.com/read/gscqdhnwzsfg) يمكنك كتابته باستخدام markdown *و* لتحويله إلى كتيب صغير. [![A recipe booklet produced on Overleaf using markdown](/files/f1f8e2790c4f74788d9c006b25ed36b739f138e0)](https://www.overleaf.com/read/gscqdhnwzsfg) والآن يأتي جزء آخر من المتعة. خلف الكواليس، لا يزال هذا LaTeX، لذا يمكننا مواصلة تنسيق العناصر المختلفة — العناوين الفرعية، القوائم النقطية، الخطوط، وما إلى ذلك — باستخدام حزمة حيل LaTeX المعتادة. وهنا اندفعتُ قليلًا وأتيت بـ *ثلاثة* «سمات» لـ `simple-recipe` الفئة! ### إضافة 1: بعض التحفظات عند استخدام حزمة markdown * لن يعمل SyncTeX تمامًا. في Overleaf، يعني هذا أن عمليتي «الموضع في المعاينة» و«النقر في المعاينة للانتقال إلى المصدر» لن تعملا في `markdown` المناطق. * `\\` يفقد معناه المعتاد: «مسافتان ثم سطر جديد» المعتاد `markdown` الخدعة لا تعمل هنا لأن المسافات اللاحقة ستُزال بواسطة محلل Lua، كما هو موضح في [`markdown` توثيق الحزمة](http://texdoc.net/pkg/markdown). `\newline` مع ذلك سيعمل. * احذر من وجود عدة محارف شرطة سفلية في السطر نفسه — فقد تكون هذه مشكلة إذا: * كنت تعمل مع الكثير من الرموز السفلية في معادلاتك (نصيحة: اخرج من `markdown` البيئة في مثل هذه الحالات); * كنت تحب استخدام الشرطات السفلية في مفاتيح BibTeX الخاصة بك. يمكنك ضبط `underscores=false` مع أحدث `حزمة markdown` الملفات لجعل الشرطات السفلية الخاصة بالرموز السفلية تعمل، لكنه سيظل لا يعمل مع الشرطات السفلية في مفاتيح BibTeX. **تحديث** (13 مايو 2017): ستعمل الشرطات السفلية في مفاتيح BibTeX مع `markdown` الإصدار v2.5.2 فما فوق — شكرًا، فيت! * ستواجه بعض الصعوبات في عرض حرف الهاش حرفيًا لأن حتى `\#` لن يعمل! عادةً ما أعرّف أمرًا جديدًا وأستخدمه بدلًا من ذلك. ### إضافة 2: ميزات جديدة في حزمة markdown المحدَّثة `markdown` أضاف الإصدار v2.4 والإصدارات اللاحقة دعمًا لبعض الصيغ الرائعة جدًا: * **صيغة الحاشية السفلية المضمّنة**: `...^[هذه هي الحاشية السفلية]` (يتطلب خيار `inlineFootnotes` ) * **الاستشهادات:**`[@smith1990]` (يتطلب خيار `الاستشهادات` ؛ واحذر أيضًا من الشرطات السفلية في مفاتيح BibTeX الخاصة بك!) * **الرمز داخل كتلة**: يمكنك استخدام إما علامات التلدة `~` أو علامات backticks `` ` `` كحدّ فاصل. ``` ~~~~ int main() { cout << "Hello world!"; return 0; } ~~~~ ``` إذا أردت استخدام هذه الميزات الجديدة، فتأكد من تحميل الإصدارات المحدَّثة من `markdown.lua`, `markdown.tex` و `markdown.sty` إلى مشروعك — أو يمكنك ببساطة إنشاء مشروع جديد من [هذا القالب](https://www.overleaf.com/read/whdrnpcpnwrm). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/ar/mqalat-mtamqh/32-markdown-into-latex-with-style.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.