محول HTML إلى Markdown

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

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

من يحتاج هذا غالبًا هو من ينقل صفحة من موقع قديم، أو مقالًا مُصدَّرًا من محرر نصوص بتنسيق HTML، إلى ملف README لمشروع برمجي، أو إلى موقع ساكن يُبنى من ملفات Markdown، أو إلى تطبيق ملاحظات، أو إلى مستودع توثيق يقرأ Markdown مباشرة.

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

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

لماذا لا توجد أداة تحويل دقيقة مئة بالمئة

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

ولقياس هذه الأداة فعليًا بدل الاكتفاء بادّعاء، أُخذت كل واحدة من مخرجات HTML الـ652 المتوقعة في بطارية اختبارات CommonMark، وحُوّلت إلى Markdown بهذه الأداة، ثم أُعيد تحويل ذلك Markdown إلى HTML للنظر هل عاد كما كان. 472 من 652 عادت مطابقة بايتًا ببايت (72.4%)، و540 من 652 (82.8%) عادت مطابقة إذا أُهملت المسافات البيضاء غير المؤثرة بين الوسوم.

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

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

من أين يأتي الفارق، ولماذا نُبقي HTML الذي لا مقابل له

من أصل 112 حالة لم تعد مطابقة، خمس وخمسون منها — أي أقل من النصف بقليل — هي أقسام كتل HTML وHTML الخام في المواصفة نفسها: أي HTML لا صياغة له في Markdown إطلاقًا. والـ57 الباقية ذيل رفيع تعود فيه نسخة مكافئة لكن مكتوبة بطريقة مختلفة: تسعة اختلافات في القوائم، وتسعة في الروابط، وسبعة في عناصر القوائم، وستة في الشيفرة داخل السطر، وخمسة في كتل الشيفرة، وخمسة في التوكيد، وأرقام آحادية في البقية.

والخلاصة الأكبر هنا ليست عن هذه الأداة بل عن Markdown نفسه: هو لا يستطيع التعبير عن كل ما يعبّر عنه HTML. فله صياغة للعناوين والفقرات والقوائم والاقتباسات والشيفرة والتوكيد والروابط والصور والخطوط الفاصلة، ولا شيء غير ذلك. أما عنصر div أو span أو صنف CSS أو معرّف أو محاذاة خلية جدول أو فيديو مضمّن، فلا صياغة لأي منها مهما كانت الأداة جيدة.

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

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

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

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