Markdown إلى HTML

يستعمل التحويل GitHub Flavoured Markdown، وهي اللهجة التي يكتبها معظم الناس فعلًا: جداول وكتل شفرة محاطة وشطب وروابط تلقائية فوق المواصفة الأصلية.

وفواصل الأسطر هي الإعداد الذي يفاجئ الناس. ففي Markdown المعياري لا يكون السطر الجديد المفرد فاصل سطر — إذ تفصل الفقرات أسطر فارغة، والنص الملفوف على عدة أسطر يصير فقرة واحدة. وذلك مقصود، وهو سبب أن Markdown المكتوب في محرّر ضيّق يُعرض عرضًا صحيحًا رغم ذلك.

والمعاينة تحت HTML تعرض محتواك أنت في متصفّحك أنت. لا شيء يُجلب ولا شيء يُرسَل؛ وما تراه هو الترميز نفسه بالضبط في الصندوق فوقها.

والمخرجات HTML دلالي مجرّد بلا أصناف ولا أنماط مضمّنة، وهو ما تريده للّصق في نظام إدارة محتوى أو قالب بريد يجلب تنسيقه معه.

تحتفظ بملاحظات الإصدار بصيغة Markdown وتحتاجها HTML لصفحة سجلّ تغييرات. اضغط حمّل عيّنة.

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

والمعاينة هي حيث تظهر الأخطاء. فالقائمة التي تُعرض فقرةً واحدة تعني في الغالب الأعمّ سطرًا فارغًا ناقصًا قبلها — فـMarkdown يحتاج واحدًا بين فقرة والقائمة التي تليها.

وأمر واحد ينبغي الحذر منه. يسمح Markdown بـHTML خامّ، وهو يمرّ بلا تغيير. وذلك ميزة حين تحتاج كتلة <details>، وخطر إن كان Markdown آتيًا من مكان لا تتحكّم فيه — فلصق المخرجات في صفحة سيحمل معه أي وسوم نصوص برمجية. حوّل محتواك أنت بحرّية؛ وطهّر أي شيء من مكان آخر قبل نشره.

وللاتجاه الآخر، HTML إلى Markdown هي الأداة لإنقاذ المحتوى من نظام إدارة محتوى.