ورقة مرجعية لـ Markdown
مرجع سريع لقواعد Markdown — العناوين والقوائم والروابط وكتل الكود والجداول والمزيد، مع معاينة للتصيير الفوري.
طريقة الاستخدام
- تصفح جدول المحتويات على اليسار للانتقال إلى أي فئة من فئات القواعد.
- تعرض كل بطاقة قواعد Markdown الخام على اليسار والنتيجة المُصيَّرة على اليمين.
- انقر على زر النسخ لنسخ المقتطف إلى الحافظة.
- استخدم هذه المقتطفات مباشرةً في GitHub أو Notion أو VS Code أو Obsidian أو أي محرر Markdown.
الأسئلة الشائعة
-
ما هو Markdown؟
Markdown هو لغة ترميز خفيفة أنشأها John Gruber في عام 2004. تتيح كتابة النصوص المنسقة باستخدام رموز النص العادي — مثلاً، إحاطة النص بـ ** يجعله عريضاً. يتم تحويل ملفات Markdown إلى HTML بواسطة محركات التصيير المستخدمة في GitHub ومنصات المدونات وأدوات التوثيق وتطبيقات الملاحظات.
-
هل Markdown متماثل في كل مكان؟
تكون القواعد الأساسية متسقة إلى حد بعيد، لكن المنصات المختلفة تدعم امتدادات مختلفة. يضيف GitHub Flavored Markdown قوائم المهام والنص المشطوب والجداول. يدعم Obsidian الروابط التشعبية بأسلوب ويكي. تستخدم بعض المنصات CommonMark كمعيار. تركز هذه الورقة المرجعية على الميزات الأكثر دعماً.
-
كيف أضيف سطراً جديداً في Markdown؟
اختم السطر بمسافتين ثم اضغط Enter لإنشاء فاصل سطري ناعم. لفاصل الفقرة، اترك سطراً فارغاً بين السطرين. في كثير من محركات التصيير، يُعامَل فاصل سطري واحد بدون مسافات لاحقة كمسافة وليس فاصل سطر.
-
هل يمكنني استخدام HTML داخل Markdown؟
تسمح معظم محركات تصيير Markdown بـ HTML المضمّن. على سبيل المثال، يمكنك استخدام <br> لفاصل السطر، و<u>النص</u> للتسطير، أو <details> للأقسام القابلة للطي. ومع ذلك، يتفاوت الدعم — تُزيل بعض محركات التصيير المعنية بالأمان HTML بالكامل.
ما هو Markdown؟
Markdown هو بنية نص عادي يتحول إلى HTML. أنشأه John Gruber في 2004، وصُمِّم ليكون مقروءاً كما هو — ينبغي أن يبدو النص الخام كنص منسق حتى بدون تصيير. اليوم يستخدم في كل مكان: ملفات README في GitHub، والتوثيق التقني، ومنصات المدونات، وتطبيقات تدوين الملاحظات كـ Obsidian وNotion، وأدوات الدردشة مثل Slack وDiscord.
الفكرة الأساسية بسيطة: استخدام أحرف عادية للدلالة على التنسيق. وضع # قبل سطر يجعله عنواناً. إحاطة النص بـ ** يجعله عريضاً. إزاحة سطر بأربع مسافات يحوله إلى كتلة كود.
كيف تساعد ورقة Markdown المرجعية
حتى الكتّاب المتمرسون ينسون أحياناً القواعد الدقيقة لمحاذاة أعمدة الجداول أو القوائم المتداخلة أو كتل الكود مع تمييز بنائي. تعمل الورقة المرجعية كأداة بحث سريع — ترى القواعد الخام والنتيجة المُصيَّرة جنباً إلى جنب.
تشمل هذه الورقة المرجعية:
- العناوين — أربعة مستويات من h1 إلى h4
- تنسيق النص — العريض والمائل والمشطوب والكود المضمّن والروابط التشعبية
- القوائم — مرتبة وغير مرتبة ومتداخلة وقوائم المهام
- الروابط والصور — الروابط المضمّنة والروابط بعنوان والصور
- الاقتباسات — بسيطة ومتداخلة
- كتل الكود — مسيّجة مع خيار اللغة للتمييز البنائي
- الجداول — مع خيارات محاذاة الأعمدة
- الفواصل الأفقية — كفواصل بصرية
لهجات Markdown
CommonMark مواصفة موحدة تحل الغموض في المواصفة الأصلية. تتبع GitHub وGitLab وDiscord والعديد من المنصات الأخرى CommonMark أو ما يشبهه.
GitHub Flavored Markdown (GFM) يضيف قوائم المهام (- [x])، والنص المشطوب (~~نص~~)، والجداول، والروابط التلقائية. تدعم معظم منصات الكود GFM أو مجموعة أعلى منه.
للكتابة التقنية اليومية — ملفات README والتوثيق ومقالات المدونة والملاحظات — يغطي CommonMark القياسي مع امتدادات GFM كل ما تحتاجه تقريباً.
نصائح لكتابة Markdown جيد
كن متسقاً في علامات القوائم. اختر - أو * للقوائم غير المرتبة والتزم باختيارك. المزج صحيح نحوياً لكنه أصعب قراءةً في الشكل الخام.
استخدم أسطراً فارغة بين العناصر الكتلية. سطر فارغ قبل وبعد العناوين وكتل الكود والاقتباسات يضمن التصيير الصحيح في محللات مختلفة.
افضّل كتل الكود المسيّجة على المتراجعة. تسمح الكتل ذات الشرطات الثلاثية بتحديد اللغة للتمييز البنائي وهي أوضح بصرياً في المصدر.
استخدم نص رابط وصفي. [انقر هنا](url) أسوأ من [مواصفة Markdown](url) من حيث القراءة وسهولة الوصول.