الدرس الأول — مقدمة في Markdown

إذا كنت تعمل على GitHub — سواء على مشاريع شخصية أو ضمن فريق — ستصادر Markdown في كل خطوة. تعلّمها مرة واحدة ثم تستخدمها في كل مكان، من أول سطر في README.md إلى آخر تعليق في Pull Request.

١. ما هو Markdown ولماذا يهمّك؟

Markdown هي لغة خفيفة لتنسيق النصوص العادية. تستخدمها على GitHub لتنسيق ملفات README، وصف الـ Issues والـ Pull Requests، والتعليقات، وحتى ملفات تعليمات الوكلاء (Agent Instructions).

لماذا تتعلّمها؟

• تجعل مشاريعك أكثر وضوحاً وسهولة للقراءة
• README نظيف = انطباع أول ممتاز على كل من يزور مستودعك
• بمجرد إتقانها ستجد نفسك تستخدمها في كل مشروع

٢. أين يمكنك استخدام Markdown؟

• README — المكان الأشهر
• Issues & Pull Requests — وصف ومتابعة
• Discussions & Wikis — توثيق المشاريع
• خارج GitHub — تطبيقات المذكرات، منصات المدونات، أدوات التوثيق

٣. الصياغة الأساسية

العناوين (Headers)

أضف # قبل النص. كلما زادت علامات # صغُر العنوان.

# عنوان رئيسي (H1)
## عنوان فرعي (H2)
### عنوان أصغر (H3)

التمييز النصي (Bold & Italic)

استخدم * أو _ للتمييز:

هذا *نص مائل*
هذا **نص غامق**
___هذا غامق ومائل معاً___

الاقتباس (Blockquote)

أضف > في بداية السطر:

> لا يلزمك تصميم.
>
> لا تفكّر كثيراً.
>
> فقط أرسل عملك.

٤. القوائم

قائمة مرتّبة (Ordered List)

رقّم كل عنصر بـ 1. — Markdown ترتّب تلقائياً ولا داعي لإعادة الترقيم عند الإضافة:

1. اضغط زر "Use this template" في أعلى المستودع.
1. سمِّ مستودعك الجديد (مثال: my-portfolio).
1. استنسخ المستودع وابدأ التخصيص.

قائمة غير مرتّبة (Unordered List)

استخدم - أو * أو +:

* اضغط زر "Use this template".
* سمِّ مستودعك الجديد.
* استنسخ المستودع وابدأ التخصيص.

قائمة متداخلة (Nested List)

أضف 4 مسافات للتداخل:

1. اضغط زر "Use this template".
   - يقع في أعلى المستودع.
   - سيُنشئ مستودعاً جديداً من القالب.
1. سمِّ مستودعك الجديد.
   - مثال: my-portfolio
   - يمكن إنشاؤه تحت حسابك الشخصي.
1. استنسخ المستودع وابدأ التخصيص.

٥. الكود

كود في سطر واحد (Inline Code)

أحِط الكود بعلامة backtick مفردة ` :

`git clone https://github.com/YOUR_USERNAME/YOUR_REPO.git`

النتيجة: git clone https://github.com/YOUR_USERNAME/YOUR_REPO.git

كتلة كود متعددة الأسطر (Code Block)

استخدم ثلاث backticks مع اسم اللغة:

```bash
# استنسخ المستودع
git clone https://github.com/YOUR_USERNAME/YOUR_REPO.git
cd YOUR_REPO

# ثبّت الاعتماديات
npm install

# شغّل خادم التطوير
npm run dev
```

٦. الروابط والصور

الروابط (Links)

الصيغة: [النص المعروض](الرابط) — بدون مسافة بين القوسين:

افتح [localhost الخاص بك](http://localhost:3000) لعرض مشروعك.

الصور (Images)

نفس صيغة الروابط لكن أضف ! في البداية:

![Mona](https://avatars.githubusercontent.com/u/92997159?v=4)

تمرين عملي