مرجع سريع لقواعد Markdown: من المبتدئ إلى المتقدم

المقدمة

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

القواعد الأساسية

العناوين (Headings)

يدعم Markdown ستة مستويات من العناوين، باستخدام رمز #:

# العنوان الرئيسي
## العنوان الثانوي
### العنوان من المستوى الثالث
#### العنوان من المستوى الرابع
##### العنوان من المستوى الخامس
###### العنوان من المستوى السادس

يمكن أيضاً استخدام نمط الخط السفلي (يدعم المستوى الأول والثاني فقط):

العنوان الرئيسي
================

العنوان الثانوي
----------------

الفقرات وكسر الأسطر

يجب فصل الفقرات بسطر فارغ. إذا كنت تريد كسر السطر دون بدء فقرة جديدة، أضف مسافتين في نهاية السطر.

هذه الفقرة الأولى.

هذه الفقرة الثانية.

هذا سطر  
وهذا السطر التالي (لاحظ المسافتين في نهاية السطر السابق)

تنسيق النص

التأثير	القاعدة	المثال
نص عريض	**النص** أو __النص__	نص عريض
نص مائل	*النص* أو _النص_	نص مائل
نص عريض ومائل	***النص*** أو ___النص___	نص عريض ومائل
خط متوسط	~~النص~~	نص بخط متوسط
نص مسطر	<u>النص</u>	نص مسطر

القوائم

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

استخدم - أو + أو * لإنشاء قوائم غير مرقمة:

- العنصر الأول
- العنصر الثاني
  - عنصر فرعي 2.1
  - عنصر فرعي 2.2
- العنصر الثالث

+ يمكن أيضاً استخدام علامة الجمع
* أو النجمة

القوائم المرقمة

استخدم الأرقام مع النقطة لإنشاء قوائم مرقمة:

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

قوائم المهام

قوائم المهام بنمط GitHub:

- [x] مهمة مكتملة
- [ ] مهمة معلقة
- [ ] مهمة أخرى معلقة

الروابط

الروابط المضمنة

[نص الرابط](https://www.example.com)
[رابط مع عنوان](https://www.example.com "عنوان الرابط")

الروابط المرجعية

[نص الرابط][معرف المرجع]

[معرف المرجع]: https://www.example.com "عنوان اختياري"

الروابط التلقائية

<https://www.example.com>
<[email protected]>

الصور

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

صورة مرجعية:
![النص البديل][مرجع_الصورة]

[مرجع_الصورة]: رابط_الصورة "عنوان اختياري"

الاقتباسات

> هذا اقتباس
> يمكن أن يكون متعدد الأسطر
> 
> > ويمكن أيضاً أن يكون متداخلاً

الكود

الكود المضمن

استخدم `الإشارة العكسية` لتحيط بالكود المضمن

كتل الكود

استخدم ثلاث إشارات عكسية أو إزاحة أربع مسافات:

```javascript
function hello() {
    console.log("مرحبا بالعالم!");
}
```

    أو استخدم الإزاحة (أربع مسافات)
    function hello() {
        console.log("مرحبا بالعالم!");
    }

الخطوط الفاصلة

استخدم ثلاثة أو أكثر من الشرطات أو النجوم أو الشرطات السفلية:

---
***
___

القواعد المتقدمة

الجداول

| العمود 1 | العمود 2 | العمود 3 |
|---------|---------|---------|
| بيانات 1 | بيانات 2 | بيانات 3 |
| بيانات 4 | بيانات 5 | بيانات 6 |

طرق المحاذاة:
| محاذاة يسار | توسيط | محاذاة يمين |
|:-----------|:----:|----------:|
| يسار | وسط | يمين |

الحواشي السفلية

هذا مثال على حاشية سفلية[^1].

[^1]: هذا محتوى الحاشية السفلية.

قوائم التعريفات

المصطلح الأول
: التعريف الأول

المصطلح الثاني
: التعريف 2أ
: التعريف 2ب

الاختصارات

HTML هي لغة ترميز النص التشعبي.

*[HTML]: HyperText Markup Language

GitHub Flavored Markdown (GFM)

تمييز القواعد

حدد اللغة في كتل الكود:

```python
def hello():
    print("مرحبا بالعالم!")
```

```json
{
  "name": "مثال",
  "version": "1.1.0"
}
```

الرموز التعبيرية

:smile: :heart: :thumbsup: :star:

إشارات المستخدمين ومراجع المسائل

@اسم_المستخدم
#123 (رقم المسألة)
منظمة/مستودع#123

دعم HTML

يدعم Markdown HTML المضمن:

<div style="color: red;">
  هذا نص أحمر
</div>

<details>
  <summary>اضغط للتوسيع</summary>
  المحتوى المخفي
</details>

أحرف الهروب

استخدم الشرطة المائلة العكسية لتجاهل الأحرف الخاصة:

\* ليس نصاً مائلاً
\# ليس عنواناً
\[ليس رابطاً\]

الأحرف التي تحتاج لهروب:

\ ` * _ {} [] () # + - . ! |

أفضل الممارسات

1. الحفاظ على الثبات

• اختر نمط عناوين واحد والتزم به
• استخدم * أو - بشكل موحد لعلامات القوائم
• حافظ على ثبات الإزاحة (عادة 2 أو 4 مسافات)

2. إعطاء الأولوية للقابلية

• أضف أسطر فارغة قبل وبعد العناوين
• افصل الفقرات بأسطر فارغة
• تجنب الأسطر الطويلة جداً (يُنصح بـ 80-100 حرف)

3. الاستخدام الدلالي

• استخدم العناوين بحسب التسلسل الهرمي، لا تتخط المستويات
• استخدم العلامات المناسبة (مثل القوائم والاقتباسات)
• قدم نصوصاً وصفية للروابط والصور

الأخطاء الشائعة

1. أخطاء تنسيق القوائم

خطأ:
-العنصر الأول (مسافة مفقودة)
- العنصر الثاني

صحيح:
- العنصر الأول
- العنصر الثاني

2. أخطاء تنسيق الروابط

خطأ:
(نص الرابط)[الرابط]

صحيح:
[نص الرابط](الرابط)

3. إزاحة كتل الكود

خطأ:
```
الكود
```

صحيح:
```
الكود
```

نصائح الأدوات

استخدام MD-PDF-WORD

يدعم MD-PDF-WORD جميع قواعد Markdown هذه تماماً، ويمكنه تحويلها بدقة إلى صيغ PDF و Word:

• يحتفظ بجميع التنسيقات
• يعرض الجداول بشكل صحيح
• يدعم تمييز الكود
• يتعامل مع تنسيق النصوص العربية

اختصارات لوحة المفاتيح (للمحررات الشائعة)

الوظيفة	Windows/Linux	Mac
عريض	Ctrl + B	Cmd + B
مائل	Ctrl + I	Cmd + I
رابط	Ctrl + K	Cmd + K
كود	Ctrl + `	Cmd + `

مصادر التعلم

• المواصفات الرسمية: وثائق Markdown الرسمية
• دليل GitHub: دليل GitHub Markdown
• تعليم تفاعلي: تعليم Markdown
• معاينة مباشرة: استخدم وظيفة المعاينة الفورية في MD-PDF-WORD

الخلاصة

إتقان قواعد Markdown يمكن أن يجعلك تنشئ مستندات منسقة بكفاءة أكبر. من تنسيق النص الأساسي إلى الجداول وكتل الكود المتقدمة، يوفر Markdown قواعد غنية ومختصرة. مع أدوات مثل MD-PDF-WORD، يمكنك بسهولة تحويل مستندات Markdown إلى صيغ PDF أو Word احترافية، لتلبية احتياجات مختلف المستندات.

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