معاين Markdown: اكتب بصيغة بسيطة، شاهد النتيجة فوراً، وانسخ HTML نظيفاً وآمناً
تكتب ملف README لمشروعك، أو منشوراً في مدونة، أو وثيقة لفريقك، وتستخدم الرموز البسيطة: نجمتان للخط الغامق، وعلامة # للعنوان، وشرطة للقائمة. لكنك لا تعرف كيف سيبدو الناتج حتى تنشره. معاين Markdown في ساهل يعرض لك النتيجة وأنت تكتب، ثم ينسخ لك ناتج HTML إن أردته لموقعك، دون تسجيل ودون رفع نصك إلى أي خادم.
ما هو Markdown ولماذا انتشر
Markdown صيغة كتابة صممها جون غروبر عام 2004، فكرتها أن النص يبقى مقروءاً وهو خام، ثم يتحول بسهولة إلى HTML منسق. تفهمه منصات كثيرة منها GitHub وGitLab ومنتديات النقاش وأدوات التوثيق وتطبيقات الملاحظات. ميزته أنك لا تحتاج إلى فتح قائمة تنسيق أو تذكر وسوم HTML، بل تكتب بيدين على لوحة المفاتيح.
القواعد الأساسية
- العناوين: علامة # للعنوان الأكبر، و## للثاني، وهكذا حتى ستة مستويات.
- الغامق والمائل: نجمتان حول النص للغامق، ونجمة واحدة للمائل، وعلامتا ~~ للشطب.
- القوائم: شرطة أو نجمة في بداية السطر للقائمة النقطية، ورقم ونقطة للمرقمة، ويمكن تداخلها.
- قوائم المهام: - [ ] لمهمة غير منجزة و- [x] لمنجزة.
- الروابط والصور: النص بين قوسين مربعين يتبعه العنوان بين قوسين عاديين، وتسبقه علامة تعجب للصورة.
- الاقتباس: علامة > في بداية السطر.
- الشيفرة: علامة اقتباس عكسية واحدة حول الشيفرة داخل السطر، وثلاث علامات قبل المقطع وبعده للكتل.
- الجداول: أعمدة تفصلها الخطوط العمودية، وسطر ثانٍ من الشرطات يفصل العناوين.
- الخط الفاصل: ثلاث شرطات في سطر مستقل.
المعاينة المباشرة: كيف تفيدك
أكثر أخطاء Markdown خفية: مسافة ناقصة بعد علامة # فلا تتحول إلى عنوان، أو سطر فارغ مفقود قبل قائمة فلا تظهر قائمة، أو عمود في جدول بعدد خانات مختلف. حين ترى النتيجة وأنت تكتب تكتشف هذه المشاكل فوراً بدل أن تنشر ثم تعدّل. وفي المعاينة تتحقق من العناوين المتدرجة، فتعرف إن كان التدرج منطقياً لقارئ الشاشة ومحركات البحث.
الأمان: لماذا لا يمرّر المعاين HTML الخام
يسمح كثير من محللات Markdown بكتابة HTML داخل النص، وهنا الخطر. لو لصقت نصاً من مصدر لا تثق به وفيه وسم سكربت، وعرضه المعاين بلا حذر، فسينفذ الشيفرة في صفحتك. هذا هجوم معروف يسمى حقن السكربت. يتجنب معاين ساهل ذلك بتصميمه: أي HTML تكتبه يُعرض نصاً كما هو لا عنصراً فعلياً، فيظهر لك <script> حرفياً ولا يعمل.
وكذلك الروابط. رابط يبدأ بـ javascript: قد ينفذ شيفرة عند الضغط عليه. لذلك لا تصبح روابط المعاين قابلة للنقر إلا إذا بدأت بـ http أو https أو mailto أو tel أو كانت مسارات نسبية. أما غيرها فيعرض نص الرابط عادياً دون رابط. وينطبق الأمر على عناوين الصور.
لا تعرض أبداً نصاً من مصدر خارجي بتنسيق HTML دون تنقية. معاين آمن يتعامل مع كل ما تلصقه على أنه نص أولاً.
ما لا يدعمه المعاين
الأداة تدعم مجموعة جزئية مختارة بعناية من Markdown، وتعرض ما لا تدعمه كما كتبته بدل أن تتعامل معه نصف تعامل. لا تُعرض الوسوم HTML الخام، ولا الروابط المرجعية المعرّفة في أسفل المستند، ولا الكتل البرمجية بالمسافات الأربع في بداية السطر، ولا الرموز النصية مثل ©. فإن احتجت إلى كتلة شيفرة فاستعمل ثلاث علامات اقتباس عكسية.
نصائح لكتابة Markdown نظيف
- اترك سطراً فارغاً بين الكتل: بين الفقرة والقائمة، وبين القائمة والعنوان، لتتجنب التحولات غير المتوقعة.
- لا تقفز بين مستويات العناوين: انتقل من ## إلى ### لا إلى ####، فهذا أفضل لقراءة الشاشة ولمحركات البحث.
- اكتب نصاً وصفياً للروابط: «اقرأ دليل التثبيت» أفضل من «اضغط هنا».
- أضف نصاً بديلاً للصور: فهو يظهر حين لا تُحمّل الصورة ويقرؤه قارئ الشاشة.
نسخ HTML لموقعك
بعد أن يعجبك الشكل تستطيع نسخ ناتج HTML. هو HTML بسيط يستخدم العناصر القياسية: عناوين وفقرات وقوائم وجداول وشيفرة، دون أنماط ولا سكربتات، فتضعه في قالب موقعك ليأخذ شكله من أنماطك. واحرص على تنقية أي مدخل غير موثوق في خادمك أيضاً، فلا تعتمد على المعاينة وحدها.
خطوات الاستخدام
- اكتب Markdown في تبويب «كتابة» أو الصق مستنداً جاهزاً.
- انتقل إلى «معاينة» لترى الشكل النهائي.
- عدّل حتى ترضى عن الناتج، وراقب عدد الكلمات والأحرف.
- اضغط «انسخ HTML» إن أردت الناتج لموقعك.
سيناريو واقعي
مطورة تكتب ملف README لمكتبة مفتوحة المصدر. تكتب العنوان وفقرة التعريف وجدولاً بالخيارات وقسماً للتثبيت فيه كتلة شيفرة. في المعاينة تلاحظ أن الجدول لم يظهر كجدول، ثم تكتشف أنها نسيت سطر الشرطات تحت العناوين. تصلحه في ثوانٍ، ثم تنسخ النص إلى المستودع وقد تأكدت أن الصفحة ستبدو كما أرادت من أول نشر.
أسئلة شائعة
ما ميزات Markdown المدعومة؟
العناوين والقوائم والجداول والاقتباسات والشيفرة والروابط والصور والتنسيق المضمّن.
هل يعمل HTML داخل النص؟
لا. يُعرض كنص عادي حتى لا يمكن تنفيذ سكربت في المعاينة.
ماذا عن الروابط؟
تعمل http وhttps وmailto وtel والمسارات النسبية فقط، وتُعطّل الأنواع الأخرى مثل javascript:.
هل يُحفظ نصي أو يُرسل؟
لا. يبقى في متصفحك ولا يُرسل إلى أي خادم.
هل الناتج مطابق لما يعرضه GitHub؟
قريب في القواعد الأساسية، لكن GitHub يدعم ميزات أكثر. اعتبر المعاينة تقديراً للأساسيات وراجع الناتج النهائي في منصتك.
