محرّر Markdown

كيفية الاستخدام محرّر Markdown

1. اكتب Markdown في جهة، وتظهر المعاينة في الأخرى فورًا.
2. استخدم شريط الأدوات أو اختصارات لوحة المفاتيح للتنسيقات الشائعة.
3. صدّر HTML أو انسخ Markdown.

الصياغة باختصار

الأساسيات تكفي، وما عداها يُبنى عليها.

فخّان شائعان: فاصل سطر واحد لا ينشئ فقرة — يلزم سطر فارغ أو مسافتان في نهاية السطر. والقوائم تحتاج سطرًا فارغًا قبلها وإلا قُرئت امتدادًا للفقرة.

العربية والاتجاه

Markdown لا يعرف الاتجاه، وHTML الناتج لا يحمل سمة اتجاه ما لم تُضفها.

ولذلك قد تظهر الوثيقة العربية بمحاذاة يسارية عند نشرها، حتى لو بدت صحيحة في المعاينة هنا — لأن المعاينة تقع داخل صفحة اتجاهها من اليمين إلى اليسار.

والحلّ عند النشر أن يُضاف dir="rtl" على العنصر الحاوي، أو أن تُضبط الصفحة كاملة على هذا الاتجاه. وMarkdown يسمح بإدراج HTML، فيمكن تغليف المحتوى بعنصر يحمل السمة.

ومسألة ثانية تظهر مع الأسطر المختلطة: سطر يبدأ بالعربية وينتهي برابط لاتيني أو رقم قد يظهر بترتيب مربك في بعض العارضات. والمحتوى سليم، والمشكلة في خوارزمية العرض ثنائي الاتجاه — وإضافة سمة الاتجاه تعالج أغلب هذه الحالات.

وفي جداول Markdown ينطبق الأمر نفسه: ترتيب الأعمدة منطقي في المصدر، وعرضه من اليمين أو اليسار تحدّده سمة الاتجاه لا الكتابة.

هل HTML الناتج آمن؟

في المعاينة هنا نعم: يُنقّى HTML المُدخل فلا تُنفَّذ أي نصوص برمجية مضمّنة.

وفي مشروعك الخاص لا يسري ذلك تلقائيًا. فMarkdown يسمح بـHTML مضمّن، وأغلب المحوّلات تمرّره كما هو. ومن يحوّل Markdown قادمًا من المستخدمين — تعليقات أو نماذج أو مشاركات — يفتح ثغرة لحقن النصوص البرمجية.

والعلاج ثابت: مرّر الناتج على أداة تنقية بعد التحويل، مثل DOMPurify. والتحويل نفسه ليس مسؤولًا عن ذلك، وتعطيل تمرير HTML وحده لا يكفي لأن وجهات الروابط قد تحمل شيفرة أيضًا.

الأسئلة الشائعة