كيفية الاستخدام
- اكتب Markdown في المحرر أو انقر على «تجربة مثال» لتحميل مستند يتضمن جدولًا وقائمة مهام.
- تابع تحديث المعاينة أثناء الكتابة. انتقل إلى «مصدر HTML» للاطلاع على الترميز الناتج.
- فعّل Markdown بنكهة GitHub أو فواصل الأسطر المفردة أو عطّلهما، بما يناسب المكان الذي ستنشر فيه النص.
- انسخ HTML إلى نظام إدارة محتوى أو رسالة بريد إلكتروني، أو نزّل النتيجة كملف .html أو .md.
كيف تعمل الأداة
يحوّل marked النص باستخدام محلّل مفتوح المصدر واسع الاستخدام، يتبع مواصفة CommonMark، ويدعم Markdown بنكهة GitHub عند تفعيل خيار GFM: جداول بأنابيب مع محاذاة الأعمدة، وقوائم مهام، ونص ~~يتوسطه خط~~، وروابط تلقائية لعناوين URL المكتوبة مباشرة. أما الحواشي السفلية والرياضيات ومخططات Mermaid، فلا تشملها هذه المواصفات، وتُعرض كنص عادي.
قد يحتوي Markdown على HTML خام، ويُمرّر هذا المحتوى كما هو، شأنه شأن معظم عارضي Markdown. لحمايتك، لا تُدرج المعاينة مطلقًا في هذه الصفحة، بل تُعرض داخل إطار معزول لا يُسمح له بتشغيل البرامج النصية أو إرسال النماذج أو فتح النوافذ المنبثقة أو الوصول إلى هذا الموقع، كما تمنع سياسة أمان المحتوى فيه البرامج النصية وأوراق الأنماط والخطوط والإطارات الخارجية. يظهر وسم <script> أو السمة onclick في Markdown ضمن مصدر HTML، لكن لا يتم تنفيذهما مطلقًا. تظهر الروابط في المعاينة لكنها لا تُفتح؛ انسخ URL إذا أردت زيارة أحدها.
تستخدم المعاينة ورقة أنماط محايدة شبيهة بما تستخدمه عارضات README الشائعة؛ وقد يعرض موقعك أو GitHub محتوى HTML نفسه بتنسيق مختلف. HTML المنسوخ هو جزء مجرد بلا أنماط؛ أما ملف .html الذي يتم تنزيله فيتضمن ورقة أنماط أساسية ليبدو مثل المعاينة. لا تتم تنقية HTML الذي تنزّله أو تنسخه، لذا إذا احتوى على برامج نصية فستُشغّل في أي مكان تلصقه فيه أو تفتحه.
أمثلة
التحقق من README قبل رفعه
الصق README.md للتحقق من محاذاة أعمدة الجدول وظهور قائمة المهام كمربعات اختيار وإحاطة كتل التعليمات البرمجية بالعلامات الصحيحة، قبل رفع الملف إلى GitHub.
الكتابة لنظام إدارة محتوى يقبل HTML
اكتب مسودة تدوينة باستخدام Markdown، ثم انقر على «نسخ HTML» والصق ترميز <h2> و<p> و<ul> في محرر HTML ضمن نظام إدارة المحتوى.
فواصل الأسطر بأسلوب المحادثات
يحتوي النص المنسوخ من تطبيق محادثة على أسطر تفصل بينها فواصل أسطر مفردة. يؤدي تفعيل «اعتبار فواصل الأسطر المفردة بمثابة <br>» إلى إبقاء الأسطر منفصلة بدل دمجها في فقرة واحدة.
الأسئلة الشائعة
هل من الآمن لصق Markdown من مصدر غير معروف؟
نعم، للمعاينة. يُعرض HTML الناتج داخل إطار معزول مع تعطيل البرامج النصية، لذلك لن يعمل هنا أي شيء حتى لو احتوى النص على وسم <script> أو معالج أحداث. انتبه إلى المكان الذي تلصق فيه HTML المُصدّر، لأنه غير منقّى.
لماذا لا تظهر صوري؟
تُحظر الصور من المواقع الأخرى افتراضيًا كي لا ترسل المعاينة أي طلبات إلى الشبكة. فعّل «تحميل الصور من مواقع أخرى» لعرضها. لا تعمل المسارات النسبية مثل ./docs/screenshot.png لأن الملفات غير موجودة هنا.
هل تدعم الحواشي السفلية أو الرياضيات أو المخططات؟
لا. تدعم الأداة CommonMark وMarkdown بنكهة GitHub (الجداول وقوائم المهام والنص الذي يتوسطه خط والروابط التلقائية). أما الحواشي السفلية ورياضيات LaTeX ومخططات Mermaid فهي إضافات تعرضها هذه المعاينة كنص عادي.
لماذا لا ينقل فاصل السطر المفرد النص إلى سطر جديد؟
في Markdown القياسي، يُعامل فاصل السطر المفرد داخل الفقرة كمسافة. أضف مسافتين في نهاية السطر، أو اترك سطرًا فارغًا، أو فعّل «اعتبار فواصل الأسطر المفردة بمثابة <br>».
الخصوصية
يُحوّل Markdown في متصفحك ولا يُرفع أو يُخزّن. لا تحمّل المعاينة أي محتوى من الإنترنت إلا إذا سمحت بتحميل الصور من مواقع أخرى؛ عندئذٍ تُطلب الصور مباشرةً من المواقع المستضيفة لها.