تحويل Markdown إلى HTML

ما معنى تحويل Markdown إلى HTML؟

Markdown صيغة نص عادي يكتب بها الناس العناوين والقوائم والروابط برموز بسيطة مثل # و* و[نص](رابط)، بدل وسوم HTML الطويلة. لكن المتصفح لا يفهم هذه الرموز مباشرة، فهو لا يقرأ إلا HTML. فتحويل Markdown إلى HTML هو الخطوة التي تترجم تلك الرموز إلى وسوم مثل h1 وul وa، كي يظهر النص منسّقًا كما قصده كاتبه بدل أن يظهر رمزًا خامًا على الصفحة.

هذه الترجمة هي ما يجري خلف الكواليس في كل ملف README وكل تعليق ومسودة مقال مكتوبة بـ Markdown. وحين يحتاج أحد أن يرى بالضبط ما سيخرج من نص معيّن، أو أن يتأكد لماذا ظهر جزء منه بشكل غير متوقع في مكان ما، فأسرع طريقة هي تحويله فعليًا ومعاينة الناتج، لا تخمين النتيجة.

كيف تستعمل الأداة؟

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

هل يمكن الوثوق بدقة التحويل؟

CommonMark مواصفة مكتوبة تنشر معها بطارية اختبار من 652 مثالًا، كل مثال يقرن قطعة Markdown بـ HTML الذي يجب أن يخرج منها بالضبط. هذا يحوّل سؤال «هل هذا المحوّل دقيق؟» إلى رقم قابل للقياس بدل انطباع عام، وهو ما لا تقدّمه تقريبًا أي صفحة تحويل أخرى.

قِسنا محرّكي تحويل راسخين على البطارية نفسها وبالتهيئة نفسها التي تعمل بها هذه الأداة. محرّك معروف بسرعته أصاب 474 مثالًا من 652، أي 72.7%. أما المحرّك الذي تعمل عليه هذه الصفحة فأصاب 649 من 652، أي 99.5%. الفارق كبير، وليس في الاتجاه الذي قد توحي به سمعة كل منهما.

الأمثلة الثلاثة المتبقية كلها من نوع واحد: مسافات بيضاء داخل اقتباس كتلي فارغ، حيث تنتظر البطارية سطرًا جديدًا بين وسم الفتح ووسم الإغلاق ولا تجده. ولا يوجد متصفح يفرّق عمليًا بين الحالتين، فالنتيجة 649 من 652 إن حُسبت حرفًا بحرف، و652 من 652 من حيث ما يظهر فعلًا على الصفحة.

أما إضافات GitHub — الجداول والنص المشطوب — فلا تغيّر هذا الرقم إطلاقًا، لأن بطارية CommonMark لا تختبر إلا الصياغة التي تعرّفها المواصفة الأساسية نفسها. وكان تحويل الروابط العارية تلقائيًا إلى روابط ضمن الخيار نفسه، وأُزيل بعد قياسه: فهو يكلّف أربعة من الأمثلة الـ652، كلها في قسم الروابط التلقائية، لأن المواصفة دقيقة في تحديد ما يصير رابطًا والنسخة المريحة أكثر تسرّعًا من ذلك.

لماذا يهم التعامل مع HTML الخام؟

مواصفة CommonMark تمرّر HTML الخام عمدًا، وتفرد له أقسامًا كاملة، لأن Markdown صُمم أصلًا ليتداخل مع HTML لا ليستبعده. وهذا بالضبط ما يجعل عرض نص Markdown كتبه شخص آخر مسألة أمنية لا مسألة تنسيق فحسب: فإن مرّر المحوّل وسم script وعُرض الناتج كما هو في صفحة، فقد مُنح نص مجهول المصدر القدرة على تنفيذ شيفرة داخل متصفح من يشاهده.

لهذا تهرّب هذه الأداة HTML الخام افتراضيًا، فيخرج كنص ظاهر بدل وسوم فعلية. ولهذا الاختيار كلفة قِستها أيضًا: بتفعيل تهريب HTML الخام تنزل النتيجة من 99.5% إلى 577 مثالًا من 652، أي 88.5%. ومن الأمثلة الـ75 التي تفشل عندئذ، 57 مثالًا هي أقسام HTML خام كاملة، والـ18 الباقية حالات يغيّر فيها وسم HTML داخل السطر طريقة تحليل ما حوله من Markdown. أي أن الإعداد الآمن يكلّف سلوك HTML الخام تحديدًا، ولا شيء غيره.

وحين يحتوي النص المُدخل على HTML خام والخيار معطّل، تقول الأداة ذلك صراحة مع عدد الوسوم المهرّبة، فلا يبقى من يستعملها حائرًا في لماذا خرجت وسومه نصًا بدل أن تُنفَّذ.

والمعاينة نفسها تُعرض داخل إطار معزول والبرمجيات النصية معطّلة فيه، فحتى مع تفعيل السماح بـ HTML الخام لا يمكن لأي وسم script ملصوق داخل النص أن يعمل هناك. هذا مهم لأن عبارة «الصق هذا النص في تلك الأداة» طريقة حقيقية يستعملها البعض لخداع غيرهم.

لماذا هذه الأداة مجانية؟

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