كيفية استخدام منسّق Markdown
- الصق نص Markdown.
- اختر علامة التعداد النقطي ونمط الترقيم والتأكيد.
- راجع المعاينة، ثم انسخ Markdown المنسّق.
مزايا منسّق Markdown
- تحويل عناوين Setext إلى ATX وإصلاح التباعد في "#Heading"
- توحيد علامات التعداد النقطي (- أو * أو +) وإعادة ترقيم القوائم المرقّمة
- محاذاة أعمدة الجداول وتوحيد صفوف المحاذاة
- توحيد علامات الغامق (**) والمائل (_ أو *) خارج الكود
- إزالة المسافات الزائدة في نهاية الأسطر (مع الاحتفاظ بفواصل الأسطر الصلبة) والأسطر الفارغة الزائدة
- معاينة HTML مباشرة ومعقَّمة للمستند المنسّق
- لا تُعدَّل كتل الكود المسيّجة (fenced) وذات المسافة البادئة أبداً
مثال على منسّق Markdown
ترتيب قائمة وجدول غير مرتّبين
الإدخال:
Title
=====
* item one
* item two
|a|b|
|-|-|
|long cell|x|النتيجة:
# Title
- item one
- item two
| a | b |
| --------- | --- |
| long cell | x |الأسئلة الشائعة حول منسّق Markdown
ما الذي يوحّده المنسّق؟
نمط العناوين (Setext → ATX مع مسافة بعد #)، وعلامات التعداد النقطي، وترقيم القوائم المرقّمة، وعلامات الغامق/المائل، ومحاذاة أعمدة الجداول، والخطوط الأفقية، والمسافات الزائدة في نهاية الأسطر، والأسطر الفارغة المفرطة.
هل تُمسّ كتل الكود؟
لا. تُنسخ كتل الكود المسيّجة (``` أو ~~~) وذات المسافة البادئة كما هي حرفياً، بما في ذلك المسافات في نهاية الأسطر.
هل المعاينة آمنة مع Markdown غير موثوق؟
نعم. يُهرَّب HTML الخام الموجود في المصدر، وتُعطَّل عناوين URL للروابط والصور التي تستخدم javascript: أو data: أو vbscript:.
ما نكهة Markdown المستخدمة؟
CommonMark مع امتدادات GitHub الشائعة: الجداول، والنص المشطوب، وقوائم المهام، والروابط التلقائية.
هل يُحتفظ بفواصل الأسطر الصلبة؟
نعم. تحتفظ الأسطر المنتهية بمسافتين أو أكثر بمسافتين بالضبط ليبقى فاصل السطر قائماً.
ملاحظات تقنية
عارض المعاينة مجموعة فرعية من CommonMark مبنية خصيصاً لهذا الغرض (العناوين، والفقرات، والتأكيد، والكود، والقوائم، وقوائم المهام، والروابط، والصور، والجداول، والاقتباسات الكتلية، والخطوط الأفقية). يُهرَّب HTML الخام ولا يُسمح في الروابط إلا بعناوين http(s) وmailto والعناوين النسبية، فلا يمكن للمستندات غير الموثوقة حقن سكربتات.