القواعد الموسعة في Markdown
توفّر قواعد Markdown الأساسية لبنات بناء الوثائق، لكنها لا تكفي لبعض الاحتياجات الخاصة؛ وهنا تأتي القواعد الموسعة.
القواعد الموسعة تضيف قدرات فوق الأساسية لصنع وثائق أغنى وأكثر تعقيداً.
ما هي القواعد الموسعة؟
المقصود بها عناصر تتجاوز مواصفة Markdown الأصلية، وتضيفها معالجات مختلفة لدعم مزايا إضافية.
القواعد الموسعة الشائعة
- الجداول - إنشاء جداول بيانات
- كتل الشيفرة المحاطة - كتل شيفرة بإبراز
- الحواشي السفلية - إضافة مرجع سفلي
- معرفات العناوين - IDs مخصصة للعناوين
- القوائم التعريفية - مصطلح وتعريفه
- الشطب - شطب النص
- قوائم المهام - قوائم بمربعات اختيار
- الرموز التعبيرية - emoji
- التمييز - إبراز النص
- السفلي والعلوي - للمعادلات الرياضية
الدعم
جدير بالذكر أن ليست كل التطبيقات تدعم القواعد الموسعة؛ تحقق من دعم المُحلّل قبل الاستخدام.
دعم شائع
منصات وأدوات تدعم القواعد الموسعة جيداً:
- GitHub Flavored Markdown (GFM) - توسعات GitHub
- GitLab Flavored Markdown - توسعات GitLab
- Typora - محرر غني
- Obsidian - إدارة معرفة
- VitePress - مولد مواقع ساكنة
- Hugo - مولد مواقع ساكنة
الجداول
إنشاء الجداول من أكثر القواعد الموسعة شيوعاً:
| الاسم | العمر | المهنة |
|-------|-------|--------|
| أحمد | 25 | مهندس |
| ليلى | 30 | مصممة || الاسم | العمر | المهنة |
|---|---|---|
| أحمد | 25 | مهندس |
| ليلى | 30 | مصممة |
كتل الشيفرة المحاطة
كتل شيفرة بإبراز الصياغة:
```javascript
function hello() {
console.log("Hello, World!");
}
```function hello() {
console.log("Hello, World!");
}قوائم المهام
إنشاء قائمة مهام:
- [x] إكمال خطة المشروع
- [ ] كتابة الشيفرة
- [ ] اختبار الوظائف
- [ ] النشر للإنتاجالشطب
يشير إلى المحتوى المحذوف أو الخاطئ:
~~هذا النص مشطوب~~هذا النص مشطوب
الروابط التلقائية
تعرف تلقائي على عناوين URL والبريد:
زر https://markdownlang.com لمزيد من المعلومات.
البريد: example@domain.comزر https://markdownlang.com لمزيد من المعلومات. البريد: example@domain.com
الحواشي السفلية
لإضافة تعليقات ومراجع:
هذا مثال على حاشية[^1].
[^1]: هذا محتوى الحاشية.هذا مثال على حاشية[^1].
[^1]: هذا محتوى الحاشية.
القوائم التعريفية
قائمة مصطلحات وتعريفات:
Markdown
: لغة ترميز خفيفة الوزن
HTML
: لغة ترميز النص الفائق
: معيار إنشاء صفحات الويبصيغ رياضية
دعم صيغ رياضية على نمط LaTeX:
الصيغة الداخلية: $E = mc^2$
الصيغة المنطقية:
$$
\sum_{i=1}^n a_i = 0
$$الرسومات والمخططات الانسيابية
تدعم بعض الأدوات المتقدمة مخططات Mermaid:
```mermaid
graph TD
A[ابدأ] --> B{هل فهمت؟}
B -->|نعم| C[واصل التعلّم]
B -->|لا| D[أعد القراءة]
D --> B
C --> E[انتهى]
```مسار تعلّم القواعد الموسعة
ننصح بالتعلّم بهذا التسلسل:
ملاحظات التوافق
عند استخدام القواعد الموسعة:
- اختبار التوافق - اختبر Markdown على المنصة الهدف
- خطة بديلة - فكّر في مخرجات المنصات غير المدعومة
- توضيح توثيقي - اذكر القواعد الموسعة المستخدمة
- توحيد معياري - اعتمدوا معياراً موحداً داخل الفريق
الخطوة التالية
اختر القواعد الموسعة التي تعجبك لبدء التعلم: