تحويل Markdown إلى HTML
حوّل Markdown إلى HTML نظيف ومتوافق مع المعايير، مع معاينة مباشرة وتلوين بناء الجملة وامتدادات GFM وخيارات التصدير، كل ذلك محليًا في متصفحك.
واجهة الأداة نفسها باللغة الإنجليزية حاليًا، وتعمل بالكامل داخل متصفحك.
جارٍ تحميل الأداة…
ما هو Markdown؟
Markdown صيغة تنسيق للنص العادي مبدؤها الأساسي سهولة القراءة: المصدر الخام يجب أن يبدو مستندًا معقولًا حتى دون عرض. فالعنوان سطر يبدأ بـ #، والتوكيد بين نجمتين، والرابط نص بين قوسين مربعين يليه عنوان بين قوسين عاديين. يُتعلَّم في دقائق، وأصبح صيغة الكتابة في GitHub ومعظم مولّدات المواقع الثابتة وكثير من الوثائق التقنية. ويعمل جيدًا مع النصوص العربية أيضًا.
ولأنه نص عادي، تظهر فروقه بوضوح في أنظمة إدارة الإصدارات ولا يحمل أبدًا تنسيقًا مخفيًا. وعرضه يعني تحليل ذلك البناء إلى HTML دلالي: العناوين تصبح عناصر عناوين، وعناصر القوائم تصبح ترميز قوائم، والكتل المسيّجة تصبح شيفرة منسقة مسبقًا. وقد حسمت مواصفة CommonMark الواسعة الانتشار الحالات الحدّية التي تركها الوصف الأصلي ملتبسة، وإن كانت الامتدادات كالجداول وقوائم المهام ما زالت تختلف بين أدوات العرض.
لماذا أنشأنا هذه الأداة
تحتاج إلى مخرجات HTML حين لا تفهم الوجهة Markdown: لصق مقال في نظام إدارة محتوى، أو بناء رسالة بريد، أو وضع محتوى منسق في صفحة ويب، أو معاينة ما ستنتجه أداة العرض بالضبط.
والمسودات غير المنشورة والملاحظات الداخلية ووثائق العملاء هي المدخلات المعتادة، ولا شيء منها يحتاج إلى الرفع من أجل تحويل نصي. محوّلنا يحلل ويعرض في المتصفح بلغة JavaScript، فيبقى المستند في التبويب ولا يُرسل أي طلب. لا حد للطول، ولا تسجيل، ولا نسخة على أي خادم، ويستمر في العمل دون شبكة.
نصائح وأخطاء شائعة
- الامتدادات كالجداول والحواشي وقوائم المهام تختلف بين أدوات العرض؛ تحقق منها في الوجهة النهائية.
- أزح الشيفرة داخل عناصر القوائم باتساق، وإلا خرج السياج من القائمة.
- السطر الفارغ مطلوب قبل القائمة أو العنوان في CommonMark الصارمة؛ ودونه يبقى السطر فقرة.
- للنصوص العربية، أضف
dir="rtl"إلى العنصر الحاوي في صفحتك حتى تُعرض بالاتجاه الصحيح.
بداية سريعة: استخدام تحويل Markdown إلى HTML
- الصق Markdown في مربع الإدخال أعلاه.
- شغّل التحويل لإنتاج HTML.
- افحص المعاينة المعروضة، مع الانتباه للجداول والكتل المسيّجة.
- انسخ HTML إلى نظام إدارة المحتوى أو القالب أو البريد.
- تذكّر أن أدوات العرض تختلف في الامتدادات، فتحقق من أي شيء يتجاوز Markdown الأساسية في وجهته النهائية.
العكس هو تحويل HTML إلى Markdown. وحوّل مستندًا مكتملًا إلى ملف قابل للمشاركة بأداة تحويل HTML إلى PDF.
لماذا تحوّل Markdown إلى HTML
Markdown صيغة للكتابة، والمتصفحات لا تعرضها. ولعرض Markdown في صفحة ويب يجب تحويلها إلى HTML أولًا: العناوين تصبح وسوم <h1>، والروابط وسوم <a>، والقوائم <ul> و<ol>. ومولّدات المواقع الثابتة وأنظمة إدارة المحتوى تفعل ذلك تلقائيًا، لكن حين تحتاج HTML يدويًا، لصفحة منفردة أو بريد أو لصق في نظام يتوقع ترميزًا، فالمحوّل يفعلها فورًا.
ما الذي يتحول
عناصر Markdown القياسية تتحول إلى HTML نظيف:
- عناوين
#تصبح<h1>إلى<h6>. **عريض**و*مائل*تصبحان<strong>و<em>.[نص](رابط)يصبح وسم رابط؛ و**** يصبح صورة.- قوائم
-و1.تصبح<ul>/<ol>بعناصر<li>. - الاقتباسات
>تصبح<blockquote>، والشيفرة بين علامتي backtick تصبح<code>.
نكهات Markdown تختلف
Markdown ليست معيارًا واحدًا. فـ Markdown العادية تغطي الأساسيات، لكن نكهة GitHub تضيف الجداول وقوائم المهام والشطب وكتل الشيفرة المسيّجة. وإذا لم يتحول جدول أو مربع اختيار كما توقعت، فالمصدر يستخدم نكهة موسعة قد يتعامل معها المحوّل بشكل مختلف. وللمحتوى القابل للنقل، التزم بالعناصر المشتركة.
استخدام الناتج
HTML المولّد جزء، أي وسوم محتواك لا صفحة كاملة. ولنشره، ضعه داخل جسم صفحتك، أو أحطه بمستند HTML كامل له <head> خاص. وإذا أردت ضغط النتيجة للإنتاج، فأداة ضاغط HTML تقلّصها.
استخدامات شائعة
- نشر ملاحظات Markdown في صفحة ويب.
- تنسيق بريد مكتوب بـ Markdown.
- اللصق في نظام إدارة محتوى يتوقع HTML.
- معاينة كيف ستُعرض Markdown.