قواعد عناوين Markdown
العناوين عنصر أساسي لتنظيم بنية الوثائق. يدعم Markdown أسلوبين: ATX وSetext.
عناوين بأسلوب ATX
لإنشاء عنوان، أضف علامة الشباك (#) قبل الكلمة أو العبارة. يحدد عدد العلامات مستوى العنوان.
markdown
# عنوان المستوى 1
## عنوان المستوى 2
### عنوان المستوى 3
#### عنوان المستوى 4
##### عنوان المستوى 5
###### عنوان المستوى 6نتيجة العرض
عنوان المستوى 1
عنوان المستوى 2
عنوان المستوى 3
عنوان المستوى 4
عنوان المستوى 5
عنوان المستوى 6
صياغة إغلاق اختيارية
يمكنك "إغلاق" العنوان بعلامات # في آخر السطر لأغراض جمالية فقط:
markdown
# عنوان المستوى 1 #
## عنوان المستوى 2 ##
### عنوان المستوى 3 ###عدد # في نهاية السطر لا يلزم مطابقته للبداية؛ عددها في بداية السطر يحدد المستوى.
عناوين بأسلوب Setext
يمكن وضع سطر تحته = لعنوان مستوى أول أو - لمستوى ثانٍ.
markdown
عنوان المستوى 1
================
عنوان المستوى 2
----------------نتيجة العرض
عنوان المستوى 1
عنوان المستوى 2
أفضل الممارسات للعناوين
اعتبارات التوافق
بعض التطبيقات تتصرف بشكل مختلف إن لم يكن هناك مسافة بين # ونص العنوان. لأفضل توافق، أضف مسافة بينهما.
| ✅ مُوصى به | ❌ غير مُوصى |
|---|---|
# هذا عنوان | #هذاعنوان |
استخدام الأسطر الفارغة
لأجل التوافق، أضف سطراً فارغاً قبل العنوان وبعده.
markdown
هذه فقرة نصية.
# هذا عنوان
هذه فقرة أخرى.مستويات العناوين
- يُفضَّل عنوان مستوى أول واحد لكل وثيقة
- حافظ على تسلسل منطقي دون قفز في المستويات
- ينبغي أن تعكس العناوين بنية الوثيقة
معايير نص العنوان
- اجعل النص موجزاً وواضحاً
- تجنب علامات الترقيم (خصوصاً النقطة)
- استخدم عبارات اسمية أو مصادر
- وحّد تنسيق العناوين في نفس المستوى
ناتج HTML
تتحول عناوين Markdown إلى وسوم HTML مقابلة:
markdown
# عنوان → <h1>عنوان</h1>
## عنوان → <h2>عنوان</h2>
### عنوان → <h3>عنوان</h3>
#### عنوان → <h4>عنوان</h4>
##### عنوان → <h5>عنوان</h5>
###### عنوان → <h6>عنوان</h6>معرفات العناوين (ميزة موسعة)
يُنشئ العديد من المعالجات مُعرّفات تلقائياً للعناوين لاستخدامها كمرساة للروابط:
html
<h1 id="markdown-قواعد-العناوين">قواعد عناوين Markdown</h1>وبذلك يمكنك الربط إلى عنوان بعينه:
markdown
[رابط إلى العنوان](#markdown-قواعد-العناوين)أمثلة تطبيقية
مثال لهيكل عناوين جيد:
markdown
# دليل استخدام المنتج
## البدء السريع
### خطوات التثبيت
#### متطلبات النظام
#### التنزيل والتثبيت
### الإعدادات الأساسية
## الميزات المتقدمة
### إعدادات مخصصة
### إدارة الإضافات
## استكشاف الأخطاء
### الأسئلة الشائعة
### الاتصال بالدعمهذا التسلسل الواضح يجعل الوثيقة سهلة القراءة والتنقل.