ما الذي تفعله الأداة
يحوّل محوّل HTML إلى Markdown ترميز HTML إلى Markdown نظيف وسهل القراءة. استخدمه لنقل مقالات المدونة من نظام إدارة محتوى إلى مولّد مواقع ثابتة، أو لكتابة ملفات README من صفحات ويب موجودة، أو لحفظ الوثائق كملاحظات، أو لتجهيز محتوى لويكي أو مشكلة على GitHub أو تطبيق دردشة يدعم Markdown.
يتبع الناتج أعراف Markdown الشائعة: عناوين # وعناصر قوائم - وكتل شيفرة مسيّجة تحتفظ باللغة الأصلية، إضافة إلى جداول ونص مشطوب بأسلوب GitHub Flavored Markdown. يتم تهريب النص عند الحاجة حتى لا يتحول شيء إلى تنسيق عن طريق الخطأ.
طريقة الاستخدام
- الصق HTML في حقل الإدخال، أو ارفع ملف
.html، أو انقر مثال. - عدّل الأسلوب إذا كان لمشروعك عرف معيّن: علامة القائمة، وكتل شيفرة مسيّجة أو بإزاحة، وعلامات المائل والعريض، وروابط مضمّنة أو بأسلوب المراجع.
- انسخ Markdown أو نزّله كملف
.md.
مثال
هذا الـ HTML:
<h2>Install</h2>
<p>Run the <strong>installer</strong> and read the <a href="https://example.com">guide</a>.</p>
<ul><li>Windows</li><li>macOS</li></ul>
يصبح Markdown التالي:
## Install
Run the **installer** and read the [guide](https://example.com).
- Windows
- macOS
نصائح
- تنسخ من المتصفح؟ استخدم مصدر الصفحة أو أدوات المطوّر لأخذ HTML عنصر المقالة فقط، حتى تبقى القوائم والتذييلات خارج النتيجة.
- تُبعد الروابط بأسلوب المراجع عناوين URL الطويلة عن النص، ما يجعل Markdown أسهل في القراءة والتحرير. تُسرد العناوين في النهاية.
- تُحذف صور
data:المضمّنة افتراضيًا لأن طولها قد يبلغ مئات الكيلوبايتات. فعّل الخيار للإبقاء عليها. - للتحويل في الاتجاه المعاكس استخدم محوّل Markdown إلى HTML أو اعرض النتيجة في معاينة Markdown.
الأسئلة الشائعة
› ما عناصر HTML التي يتم تحويلها؟
العناوين والفقرات والنص العريض والمائل والمشطوب والروابط والصور والقوائم المرقّمة وغير المرقّمة (بما فيها المتداخلة) والاقتباسات والشيفرة المضمّنة وكتل الشيفرة مع لغتها والخطوط الأفقية وفواصل الأسطر والجداول. تتحول الجداول إلى جداول GitHub Flavored Markdown.
› ماذا يحدث للسكربتات والأنماط وقسم head في الصفحة؟
تُحذف. لا ينتج عن script وstyle وnoscript وtemplate وsvg وiframe وقسم head بالكامل أي Markdown، لذا يمكنك لصق مصدر صفحة ويب كاملة والحصول على المحتوى المقروء فقط.
› وماذا عن HTML الذي لا يستطيع Markdown التعبير عنه؟
تُزال الوسوم غير المعروفة ويُحتفظ بنصها. تُحذف السمات مثل الأصناف والأنماط المضمّنة والمعرّفات لأن Markdown لا يملك صياغة لها. تحتفظ كتلة الشيفرة بلغتها عندما يحمل عنصر code صنفًا مثل language-js.
› لماذا تسبق بعض الأحرف شرطة مائلة عكسية؟
النص الذي كان سيتحول إلى تنسيق Markdown، مثل سطر يبدأ بـ 1. أو كلمات محاطة بنجوم، يتم تهريبه حتى يُعرض Markdown تمامًا مثل نص HTML الأصلي.
› هل يتم رفع HTML؟
لا. يجري التحويل في متصفحك باستخدام محلّل HTML مكتوب بلغة JavaScript، ولا يُرسل أي شيء إلى خادم.