القواعد الأساسية في Markdown
Markdown لغة ترميز خفيفة ذات صياغة بسيطة تُركّز على المحتوى لا التنضيد. تُكتب بصيغة نصية مقروءة وسهلة التحرير، ويمكن مزجها مع HTML وتصديرها إلى HTML أو PDF أو الاحتفاظ بامتدادها .md.
فلسفة التصميم
هدف Markdown هو "سهل القراءة والكتابة".
تأتي القابلية للقراءة أولاً دائماً. ينبغي أن تُنشر وثيقة Markdown كنص صِرف دون أن تبدو مليئة بالوسوم أو أوامر التنسيق.
الهدف الأول لتصميم Markdown هو أقصى قدر من القابلية للقراءة. يمكن نشر مستندات Markdown كنص صِرف دون أن تبدو محشوة بتعليمات تنسيق.
— John Gruber
التوافق مع HTML
الغاية من Markdown هي أن تكون لغة كتابة مناسبة للويب.
Markdown لا تهدف لاستبدال HTML ولا لمجاراة كل وسومها؛ قواعدها قليلة وتقابل جزءاً صغيراً من HTML.
أي الوسوم خارج نطاق Markdown يمكنك كتابتها مباشرة بـ HTML داخل المستند دون تمييز خاص.
على سبيل المثال، تضمين جدول HTML داخل ملف Markdown:
هذه فقرة عادية.
<table>
<tr>
<td>Foo</td>
</tr>
</table>
هذه فقرة عادية أخرى.تحويل المحارف الخاصة تلقائياً
في HTML هناك محرفان يحتاجان معالجة خاصة: < و&.
<لبدء الوسوم&لكيانات HTML
يسمح لك Markdown بكتابتهما طبيعياً وسيتولى التحويل اللازم. إن كان & جزءاً من كيان HTML فسيُترك كما هو، وإلا سيُحوَّل إلى &.
عناصر القواعد الأساسية
تشمل القواعد الأساسية العناصر التالية:
عناصر كتلية
- العناوين - استخدام
#لإنشاء مستويات العناوين - الفقرات وكسر السطر - قواعد الفقرات وكسر السطر
- الاقتباسات - استخدام
>لاقتباسات الكتل - القوائم - مرتبة وغير مرتبة
- كتل الشيفرة - تنسيق خاص لعرض الشيفرة
- فاصل أفقي - إنشاء فواصل أفقية
عناصر ضمن السطر
- التأكيد - نص عريض ومائل
- الروابط - إنشاء روابط
- الصور - إدراج صور
- شيفرة ضمن السطر - وسم الشيفرة داخل السطر
أخرى
- محارف الهروب - تهريب المحارف الخاصة
- روابط تلقائية - التعرّف التلقائي على الروابط
أمثلة للقواعد
مثال يضم عدة عناصر أساسية:
# مستندي
هذا مثال يحتوي على **نص عريض** و*نص مائل*.
## مثال على القوائم
### قائمة التسوق
- تفاح
- موز
- برتقال
### قائمة المهام
1. تعلّم أساسيات Markdown
2. ممارسة الكتابة
3. مشاركة الأصدقاء
> هذا مثال على كتلة اقتباس. يجعل Markdown الكتابة بسيطة وأنيقة.
هذا مثال على [رابط إلى الصفحة الرئيسية](/ar/).
مثال على الشيفرة:يمكنك أيضاً استخدام شيفرة ضمن السطر مثل console.log('Hello World').
أفضل الممارسات
استخدام العناوين
- استخدم عنوان مستوى أول واحداً (
#) لكل مستند - حافظ على تسلسل منطقي للمستويات دون قفز
- اترك سطراً فارغاً قبل العنوان وبعده
تنسيق القوائم
- حافظ على رمز موحّد للقوائم غير المرتبة (
-أو*أو+) - لا حاجة لأسطر فارغة بين العناصر إلا عند وجود فقرات متعددة
الروابط والصور
- استخدم نصوص روابط وصفية ذات معنى
- وفر نصاً بديلاً للصور (alt)
عرض الشيفرة
- استخدم صيغة ضمن السطر للمقتطفات القصيرة
- استخدم كتل الشيفرة للمقتطفات الطويلة/متعددة الأسطر
- حدد لغة الكتلة لتمييز الصياغة
دعم الأدوات
تدعم معظم تطبيقات Markdown هذه العناصر الأساسية. قد توجد فروق طفيفة بين المعالجات، لكن القواعد الأساسية مشتركة.
الخطوة التالية
الآن بعد الاطلاع على نظرة عامة، يمكنك:
- التعمّق في تعلّم كل عنصر على حدة
- الاطلاع على المرجع السريع للمراجعة
- تعلّم القواعد الموسعة لمزيد من الميزات
- استكشاف الاستخدامات المتقدمة وأفضل الممارسات
ابدأ بتعلّم العناصر الأساسية: