مرجع مختصر لتنسيق الماركداون - الهيكل والتنسيق الأكثر فائدة

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

Page content

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

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

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 من خلال تضمينه بين علامات الـ ` ). أما بالنسبة للكود في الكتل، فاستخدم ثلاث علامات قوس (``` ) قبل وبعد الكود.

كود inline

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

كود في الكتل

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

المزيد عن كتل الكود في Markdown - راجع المنشور المخصص: استخدام كتل الكود في Markdown

الخط الفاصل

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

---

الجداول

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

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

قوائم المهام

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

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

الخط المُسْتَخْرَج

يتم إنشاء النص المُسْتَخْرَج باستخدام موجهين مزدوجين (~~).

~~هذا نص مُسْتَخْرَج.~~

التلوين

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

مثال

==هذا نص مُلوَّن.==

الأقواس الصغيرة والكبيرة

يتم إنشاء الأقواس الصغيرة باستخدام رمز القفل (^) قبل النص، والأقواس الكبيرة باستخدام رمز الموج (~) قبل النص.

مثال

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

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

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

مثال

$$ E = mc^2 $$

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

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

مثال

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

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

الروابط المفيدة