دليل مختصر لكتابة النصوص بالماكروند

تذكير مفيد بأوامر المدعومة

Page content

لغة Markdown تُستخدم في ويكيبيديا و Hugo. لها دعم للعناوين، والقوائم، والتعديلات على أسلوب الخط، والصور، والاقتباسات من الكود، والجداول. هنا أحتفظ بملخص قصير عن التنسيق في Markdown.

ملف markdown في الفضاء الصورة أعلاه تم إنتاجها بواسطة Flux - نموذج النص إلى الصورة.

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

العناوين

تُنشئ العناوين في Markdown باستخدام رمز الهاش (#). عدد الهاشات قبل نص العنوان يشير إلى مستوى العنوان.

# H1
## H2
### H3
#### H4
##### H5
###### H6

التأكيد

تُوفر Markdown عدة طرق لتأكيد النص. يمكنك استخدام النجوم (*) أو الشرط (_) للنص المائل، ونجمتين مزدوجتين (**) أو شرطين مزدوجين (__) للنص المُبرز.

نص مائل

*نص مائل* أو _نص مائل_

نص مُبرز

**نص مُبرز** أو __نص مُبرز__

نص مُبرز ومائل

***نص مُبرز ومائل*** أو ___نص مُبرز ومائل___

القوائم

تدعم Markdown القوائم المرقمة والغير مرقمة.

قائمة غير مرقمة

- عنصر 1
- عنصر 2
  - عنصر فرعي 1
  - عنصر فرعي 2

قائمة مرقمة

1. العنصر الأول
2. العنصر الثاني
   1. عنصر فرعي 1
   2. عنصر فرعي 2

الروابط

يمكنك إنشاء روابط من خلال تضمين نص الرابط داخل قوسين مربعين ([]) ثم تضمين عنوان الرابط داخل قوسين عاديين (().

[نص الرابط](عنوان الرابط)

مثال

قم بزيارة [دليل Markdown](https://www.markdownguide.org/) للمزيد من المعلومات.

الصور

تُضاف الصور باستخدام علامة التعجب (!) تليها النص البديل داخل القوسين المربعين، ثم عنوان الرابط داخل القوسين العاديين.

![النص البديل](عنوان الرابط للصورة)

مثال

![شعار Markdown](https://www.markdownguide.org/assets/images/markdown-logo.png)

الاقتباسات

تُنشئ الاقتباسات باستخدام رمز أكبر من (>).

> هذا هو الاقتباس.

اقتباس مُستند

> هذا هو مستوى الاقتباس الأول.
>> هذا هو الاقتباس المُستند.

الكود Inline والكود المُجمَّع

يمكنك إضافة كود inline من خلال تضمينه داخل علامات الـ backticks (` ). أما الكود المُجمَّع، فيستخدم علامات الـ backticks الثلاثة (``` ) قبل وبعد الكود.

كود inline

استخدم `printf()` لطباعة النص في لغة C.

كود مُجمَّع

python def hello_world(): print("Hello, World!")

الخط الفاصل

يُنشئ الخط الفاصل باستخدام ثلاث أو أكثر من شرط (—)، أو نجمة (***)، أو خط (___).

---

الجداول

تُنشئ الجداول في Markdown باستخدام علامات الأفق (|) وشرط ( - ).

مثال
| عنوان 1 | عنوان 2 |
|--------|--------|
| خلية 1 | خلية 2 |
| خلية 3 | خلية 4 |

قوائم المهام

هي نوع خاص من القوائم تسمح لك بإنشاء مربعات اختيار.

مثال
- [x] مهمة مكتملة
- [ ] مهمة غير مكتملة

النص المُسحَّى

يُنشئ النص المُسحَّى باستخدام موجتين مزدوجتين (~~).

~~هذا نص مُسحَّى.~~

التأكيد

لا يدعم Markdown التأكيد بشكل أصلي، ولكن بعض المُعرضين يدعمونه باستخدام رمز ==.

مثال

==هذا نص مُؤكد.==

الأقواس السفلى والأعلى

تُنشئ الأقواس السفلى باستخدام رمز الـ caret (^) قبل النص، والأعلى باستخدام رمز الـ tilde (~) قبل النص.

مثال

H~2~O هو الماء.
E = mc^2

المعادلات الرياضية

يمكن إضافة المعادلات الرياضية باستخدام لغة LaTeX داخل رموز الدولار ($).

مثال

$$ E = mc^2 $$

تجنب الأحرف الخاصة

لتجنب الأحرف الخاصة، استخدم علامة المُهملة ().

مثال

\*نص مائل\* أو \_نص مائل\_

هذا الدليل الشامل يغطي أهمية لغة Markdown التي تحتاجها لإنشاء وثائق مُنسقة جيدًا. للمزيد من الميزات المتقدمة والتعديلات، يرجى الرجوع إلى وثائق المُعرض المحدد أو الموارد الإضافية.

روابط مفيدة