محول HTML إلى Markdown

نقل مدونة إلى مولد مواقع ثابتة، أو كتابة README من صفحة ويب، أو تنظيف محتوى منسوخ من نظام إدارة محتوى: كل ذلك يحتاج إلى Markdown. يحوّل محول HTML إلى Markdown هذا كود HTML إلى Markdown مقروء، مع الحفاظ على العناوين والقوائم والروابط والصور والتأكيد والجداول وكتل الكود، والتخلص من الوسوم الزائدة. تختار أنت نمط Markdown لتتوافق النتيجة مع مشروعك.

طريقة تحويل HTML إلى Markdown

1. الصق HTML أو ارفع ملف .html.
2. اختر نمط الإخراج من الخيارات.
3. راجع ناتج Markdown.
4. انسخه أو نزّل ملف .md.

مثال

<h2>Install</h2><p>Run <code>npm i</code> and see <a href="/ar/docs">the docs</a>.</p>

يصبح ## Install يليه Run `npm i` and see [the docs](/docs).

خيارات النمط

• العناوين: ATX (# و##) أو Setext (تسطير بـ = و-).
• النقاط: شرطة قصيرة أو نجمة أو علامة زائد.
• علامات العريض والمائل: ** أو __، و* أو _.
• كتل الكود: محاطة بـ ``` أو بإزاحة.
• الهروب للأحرف التي كانت ستُقرأ كـ Markdown، مثل * و_ في النص العادي.
• تنظيف HTML أولا لإزالة السكربتات والأنماط والحاويات الفارغة من المحتوى المنسوخ.

ما الذي يتحول جيدا

محتوى المقالات والتوثيق ورسائل البريد وصادرات أنظمة إدارة المحتوى ذات الوسوم القياسية: العناوين والفقرات والقوائم والروابط والصور والاقتباسات والكود داخل السطر وكتل الكود والجداول البسيطة. أما وسوم التخطيط مثل عناصر div المتداخلة والأنماط المضمنة والأصناف فليس لها مقابل في Markdown فتُحذف، وهذا ما تريده عادة.

نصائح

• حوّل منطقة المحتوى فقط، لا الصفحة كاملة بقوائمها وتذييلها.
• راجع الجداول: الجداول المعقدة ذات الخلايا المدمجة لا يمكن التعبير عنها في Markdown وقد تحتاج إلى إصلاح يدوي.
• الروابط النسبية ومسارات الصور تبقى كما هي؛ حدّثها إذا نُقلت الملفات.

عدّل النتيجة في محرر Markdown، أو حوّل في الاتجاه المعاكس باستخدام Markdown إلى HTML.