📝 دليل Markdown والتوثيق الشامل

التنسيق، الجداول، الروابط، وكتابة README احترافي

فهرس الدليل

دليل شامل

Markdown: فن التوثيق البسيط

📅 22 أغسطس 2026 | ⏱️ 25 دقيقة قراءة

Markdown هي لغة تنسيق خفيفة وسهلة التعلم تُستخدم لكتابة النصوص المنسقة. مثالية لملفات README، التوثيق، والمقالات التقنية.

📝 الجزء الأول: الأساسيات

1.1 العناوين والنص

# Heading 1
## Heading 2
### Heading 3

This is **bold** text
This is *italic* text
This is ~~strikethrough~~

💡 خلاصة:

  • ✅ استخدم # للعناوين (1-6).
  • ✅ **نص عريض**، *مائل*، ~~مشطوب~~.

📋 الجزء الثاني: القوائم

2.1 القوائم المرتبة وغير المرتبة

# Unordered List
- Item 1
- Item 2
  - Nested item

# Ordered List
1. First
2. Second
3. Third

💡 خلاصة:

  • ✅ استخدم - أو * للقوائم غير المرتبة.
  • ✅ استخدم 1. 2. 3. للقوائم المرتبة.

🔗 الجزء الثالث: الروابط والصور

3.1 إضافة روابط وصور

[Google](https://google.com)

![Image Alt](image.jpg)

<https://example.com>

💡 خلاصة:

  • ✅ [النص](الرابط) للروابط.
  • ✅ ![الوصف](صورة.jpg) للصور.

📊 الجزء الرابع: الجداول

4.1 إنشاء جداول منسقة

| Name | Age | City |
|------|-----|------|
| Ahmed | 25 | Cairo |
| Sara | 30 | Dubai |

💡 خلاصة:

  • ✅ استخدم | لفصل الأعمدة.
  • ✅ السطر الثاني يحدد المحاذاة (---).

💻 الجزء الخامس: الأكواد

5.1 تنسيق الأكواد البرمجية

Inline code: `console.log()`

Code block:
```javascript
function hello() {
  console.log("Hello");
}
```

💡 خلاصة:

  • ✅ \`كود\` للأكواد المضمنة.
  • ✅ \`\`\`language للأكواد متعددة الأسطر.

📚 الجزء السادس: عناصر متقدمة

6.1 اقتباسات وخطوط فاصلة

> This is a quote

---

***

💡 خلاصة:

  • ✅ > للاقتباسات.
  • ✅ --- أو *** لخط فاصل.

الجزء السابع: الملخص السريع

الصيغة النتيجة
# عنوانعنوان رئيسي
**نص**نص عريض
*نص*نص مائل
[رابط](URL)رابط تشعبي
![صورة](URL)صورة
| جدول |جدول منسق
`كود`كود مضمن

🎉 مبارك!

أصبحت الآن قادراً على كتابة ملفات Markdown احترافية لتوثيق مشاريعك.

تم نسخ الرابط!