حول هذه الأداة
Markdown هي صيغة ترميز خفيفة تتطابق مباشرةً مع مجموعة فرعية من HTML: العناوين والتوكيد والروابط والقوائم وكتل الشيفرة والاقتباسات والجداول. يعرض هذا المحوّل Markdown إلى HTML مع تمكين GitHub-flavored Markdown (GFM) — بحيث تعمل جداول الأنابيب والشطب — ثم يمرّر النتيجة عبر DOMPurify قبل أن تلمس الصفحة على الإطلاق، فيجرّد النصوص البرمجية والسمات غير الآمنة. ويسير الاتجاه العكسي عبر DOM في HTML المُحلَّل ويُصدر Markdown نظيفًا، فيحوّل جداول GFM إلى صيغة الأنابيب من جديد ويحافظ على لغات كتل الشيفرة المسيَّجة سليمة.
استخدمه لتحويل مسودة README أو سجل تغييرات إلى HTML يمكنك لصقه في نظام إدارة محتوى، أو للتحقق بدقة من HTML الذي يُنتجه Markdown الخاص بك عبر عرض HTML، أو لاستخلاص Markdown عكسيًا من مقطع HTML لصقته من صفحة توثيق أو محرر نص منسَّق. يتيح لك مبدّل Preview / HTML معاينة العرض والحصول على المصدر في مكان واحد، ويتحدّث كل شيء حيًّا أثناء الكتابة.
تُطهَّر مخرجات HTML باستخدام DOMPurify قبل العرض، فتُجرَّد النصوص البرمجية وسمات معالجات الأحداث من Markdown الخاص بك — تعكس المعاينة HTML آمنًا، لا التحويل الخام.
الأسئلة الشائعة
هل يدعم هذا المحوّل GitHub-flavored Markdown (GFM)؟
نعم. GFM مُمكَّن، لذا تُحوَّل جداول الأنابيب وكتل الشيفرة المسيَّجة مع تلميحات اللغة والشطب ~~strikethrough~~ كلها. ويُصدر اتجاه التحويل من HTML إلى Markdown أيضًا جداول أنابيب GFM.
هل HTML المُولَّد آمن للاستخدام مباشرةً؟
يُطهَّر HTML باستخدام DOMPurify الذي يزيل النصوص البرمجية ومعالجات الأحداث وغيرها من الترميز غير الآمن. وهو آمن للعرض، لكن تعامل دائمًا بحذر مع أي HTML لم تكتبه أنت قبل نشره.
هل يُرسَل Markdown أو HTML الخاص بي إلى خادم؟
لا. يُجرى كلا الاتجاهين بالكامل في متصفحك باستخدام JavaScript — مُحلّل marked وDOMPurify ومُتجوّل DOM من جانب العميل. لا يُرفع أو يُخزَّن أي شيء.