Markdown قوائم التعريفات
آخر تحديث: 2026-10-14
قوائم التعريفات إضافات شائعة
صيغة موسَّعة. يأخذ المصطلح سطرًا مستقلًا، ويبدأ سطر التعريف التالي بنقطتين، ليُعرض بهيكل <dl><dt><dd>. أداة ممتازة لكتابة المسارد وشرح المعاملات ومستندات API؛ ولا يدعمها GitHub.
| المجموعة | إضافات GFM |
|---|---|
| مستوى المواصفة | إضافات شائعة |
| إصدار المواصفة | CommonMark 0.31.2 + GFM |
📝 الصيغة
المصطلح
: محتوى التعريف▶ مثال تفاعلي
حرّر Markdown على اليسار وشاهد النتيجة على اليمين
💡 نقاط مهمة
⚠️ Warning لا يحللها GitHub ولا العارض الافتراضي لهذا الموقع، فتظهر كما هي؛ وعند الحاجة استخدم بدلًا منها هيكل HTML وهو <dl>.
ℹ️ Note تعريفات متعددة لمصطلح واحد تعني عدة أسطر تبدأ بنقطتين، وتنتج دلاليًا عناصر <dd> متعددة.
❓ أسئلة شائعة
س ما الأدوات التي تدعمها؟
ج تدعمها Pandoc وPHP Markdown Extra وkramdown في Jekyll وغيرها.
س كيف أختار بين قائمة التعريفات والجدول؟
ج عند قلة المعاملات وطول الأوصاف استخدم قائمة التعريفات؛ وعند تعدد الحقول وانتظامها استخدم الجدول.
س إلى أي هيكل يُعرض؟
ج يُغلف بـ <dl>، والمصطلح هو <dt> والتعريف هو <dd>، بدلالة واضحة تفيد إتاحة الوصول.
📚 مواضيع ذات صلة
الجداولإضافة GFM HTML مضمّننواة CommonMark