HTML to Markdown

يتعامل المحوّل مع العناوين (h1–h6) والفقرات والنص الغامق والمائل والنص المشطوب والكود المضمّن وكتل الكود المسوّرة والاقتباسات الكتلية والخطوط الأفقية والروابط والصور والقوائم المرتبة وغير المرتبة والقوائم المتداخلة والجداول — مغطياً المجموعة الكاملة لمعايير CommonMark وGitHub Flavored Markdown (GFM). تمرّر العناصر البنيوية غير المعروفة كـ div وsection وarticle أبناءها بشفافية حتى لا يُفقد أي محتوى قط. معظم HTML الواقعي — من تصدير نظام إدارة محتوى أو مقال مُستخرج أو صفحة توثيق — يتحوّل بسلاسة دون الحاجة إلى أي معالجة لاحقة من جانبك.

Pandoc محوّل سطر أوامر قوي لكنه يحتاج إلى تثبيت وطرفية ومعرفة بعلاماته. إنه الأداة المناسبة لخطوط الأنابيب الآلية من جانب الخادم، لكنه مبالغ فيه لتحويل واحد. Turndown.js هي مكتبة JavaScript الأكثر استخداماً لتحويل HTML إلى Markdown — تتجاوز 2.5 مليون تنزيل أسبوعي عبر npm وأكثر من 10,800 نجمة على GitHub — وتستخدم هذه الأداة أسلوب التحليل المستند إلى DOM ذاته الذي يجعل Turndown موثوقاً. الفرق أن كل شيء يعمل في متصفحك: لا تثبيت ولا سطر أوامر ولا رحلة ذهاب وإياب للخادم ولا ملفات تغادر جهازك. Turndown يتطلب إعداد مشروع Node؛ هذه الأداة لا تتطلب شيئاً.

Markdown هو التنسيق النصي المعياري للكتابة التقنية والتوثيق وإدارة المحتوى. يتيح لك تحويل HTML إلى Markdown استيراد المحتوى إلى Notion أو Obsidian، وإيداعه في مستودع Git جنباً إلى جنب مع الكود، ونشره عبر مولّدات المواقع الثابتة مثل Astro وHugo وJekyll، أو تغذيته إلى نماذج الذكاء الاصطناعي ونماذج اللغة الكبيرة. أظهرت أبحاث نشرت عام 2024 أن Markdown يُخفّض استهلاك الرموز بنسبة 68–87% مقارنةً بـ HTML الخام عند استخدامه مع نماذج اللغة الكبيرة — وهو فرق حقيقي في التكلفة والدقة عند بناء خطوط أنابيب RAG أو إعداد مجموعات بيانات الضبط الدقيق.

نعم — نقل نظام إدارة المحتوى هو أحد أكثر حالات الاستخدام المهنية شيوعاً. الصق HTML المصدَّر من WordPress أو Confluence أو SharePoint أو Ghost أو أي منصة أخرى واحصل على Markdown نظيف يمكنك استيراده إلى نظام جديد. يمنحك تصدير WordPress كتل محتوى HTML؛ تُصدّر Confluence الصفحات بصيغة HTML أو XHTML — كلاهما يتحوّل بسلاسة. للحصول على أفضل النتائج، الصق نص المحتوى فقط بدلاً من HTML الصفحة الكاملة بما فيها التنقل والتذييل. استخدمت فرق عمل تحويل HTML إلى Markdown المستند إلى المتصفح لنقل مواقع توثيق تضم 150–200 صفحة في أقل من يومين دون لمس سطر الأوامر.

تتحوّل الجداول إلى تنسيق الجدول الأنبوبي (pipe-table) لـ GitHub Flavored Markdown (GFM)، مع صف فاصل من الشرطات بعد صف الرأس. يعمل هذا التنسيق في GitHub وGitLab ومعاينة VS Code وNotion وObsidian وDocusaurus وكل مُصيّري Markdown الحديثة تقريباً. تُسطَّح الجداول المتداخلة لأن Markdown المعياري لا يدعمها بشكل أصلي. تُحفظ محاذاة الأعمدة — يساراً أو وسطاً أو يميناً عبر سمة align أو CSS text-align — باستخدام وضع علامات النقطتين في صف الفاصل (مثلاً: :--- لليسار، و:---: للوسط، و---: لليمين).

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

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

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

يتبع الإخراج CommonMark مع إضافات GitHub Flavored Markdown (GFM) للجداول والنص المشطوب. CommonMark هو المواصفة المعيارية التي تستخدمها معظم المنصات، وتضيف GFM صيغة الجدول الأنبوبي والشطب بـ ~~ التي تدعمها GitHub وGitLab وVS Code. هذا يجعل الإخراج متوافقاً مع GitHub وGitLab ومعاينة VS Code وNotion وObsidian وDocusaurus وMkDocs وكل مُصيّري Markdown الحديثة. إذا احتجت إلى CommonMark صارم بدون إضافات GFM، فالجداول هي العنصر الوحيد الذي سيختلف — كل شيء آخر متطابق.

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

أنظمة الذكاء الاصطناعي مثل Perplexity وChatGPT وGemini تقرأ محتوى الويب وتُجزّئه وتُعيد استخدامه لتوليد الإجابات. Markdown هو تنسيق الإدخال المُفضَّل لأنه يجرّد وسوم بنية HTML التي تستهلك رموزاً دون إضافة معنى دلالي. فقرة مُغلَّفة في وسوم <p class="article-body"> تُكلّف رموزاً أكثر من الفقرة ذاتها في Markdown العادي. تُظهر أبحاث نُشرت عام 2024 أن Markdown يُخفّض استهلاك الرموز بنسبة 68–87% مقارنةً بـ HTML الخام للمحتوى ذاته — مما يُخفّض مباشرةً تكلفة الواجهة البرمجية ويُحسّن نسبة الإشارة إلى الضوضاء لخطوط أنابيب توليد معزّز بالاسترجاع (RAG).

تُغلَّف عناصر الكود المضمّن (وسوم code غير موجودة داخل pre) بعلامة تنصيص خلفية واحدة. تُغلَّف كتل الكود (عناصر pre > code) في كتل مسوّرة بثلاث علامات تنصيص خلفية، وهو معيار CommonMark وGFM. إذا كان عنصر code يحمل صفاً مثل 'language-python' أو 'lang-python'، يُستخرج معرّف اللغة ويُحفظ في السياج الافتتاحي لتمييز الصيغة. تحتفظ كتل الكود المحوَّلة من صفحات GitHub README أو مواقع التوثيق بعلامات لغتها في الإخراج — فتمييز الصيغة الذي كان لديك في HTML ينتقل إلى Markdown.

Markdownify وh2m حزمتا npm لـ Node.js للتحويل البرمجي من HTML إلى Markdown في خط أنابيب بناء. إنهما الخيار المناسب حين تحتاج إلى أتمتة التحويل عبر مئات الملفات في سكريبت. تغطي هذه الأداة المستندة إلى المتصفح حالة الاستخدام التي لا تغطيانها: التحويلات الفردية السريعة، والمحتوى الذي لا يمكنك مشاركته مع خادم، والمواقف التي لا تريد فيها إعداد مشروع Node على الإطلاق. جودة التحويل متشابهة — تستخدم الثلاثة تحليلاً مستنداً إلى DOM بدلاً من التعبيرات النمطية — لكن هذه الأداة تضيف معاينة مباشرة وزر نسخ وأعداد الأحرف/الكلمات مما يجعلها أكثر عملية لعمل المحتوى.

نعم، يعمل المحوّل بشكل كامل على متصفحات الجوّال. الصق HTML من الحافظة، ابدأ التحويل، وانسخ نتيجة Markdown — كل ذلك من هاتف أو جهاز لوحي. تتكيّف الواجهة مع الشاشات الأصغر بأجزاء مكدّسة. تم الاختبار على Safari لنظام iOS 17 وChrome لنظام Android 14. حالة استخدام جوّال شائعة: احصل على HTML مقال من قائمة المشاركة في متصفحك، وحوّله، والصق نتيجة Markdown مباشرةً في Obsidian أو Notion على الجهاز ذاته دون الحاجة إلى حاسوب مكتبي. مجاني، بلا تسجيل، بلا قيود.

تُحذف تعليقات HTML (<!-- ... -->) من الإخراج إذ لا يوجد صيغة تعليقات في Markdown وهي نادراً ما تكون جزءاً من المحتوى الفعلي. تُسقط وسوم script ومحتوياتها أيضاً — JavaScript لا معنى له في Markdown. تُزال وسوم style وسمات style المضمّنة كذلك؛ تنسيق CSS لا يترجم إلى Markdown، والمعنى الدلالي (غامق، مائل، عنوان) يُحفظ عبر نوع العنصر لا الأسلوب البصري. إذا كان span غامقاً عبر CSS بدلاً من وسمة strong أو b، لن ينتقل هذا التنسيق — وهو السلوك الصحيح لتحويل تنسيق محتوى.

لا. لا يوجد خادم متضمَّن، لذا لا يوجد حدّ للحجم سوى ما يستطيع ذاكرة متصفحك التعامل معه. في الممارسة العملية، يمكن لمحلل DOM في المتصفح التعامل مع عدة ميغابايت من HTML دون مشاكل — أكثر بكثير من أي صفحة نظام إدارة محتوى واقعية. إذا كنت تُحوّل ملف HTML كبيراً جداً (تصدير كتاب كامل، أو مقال مُستخرج طويل جداً)، الصقه في أقسام بدلاً من دفعة واحدة للحصول على أوضح إخراج. التحويل ذاته يأخذ ميلي ثوانٍ بغض النظر عن الحجم لأنه يعمل مباشرةً في JavaScript في علامة تبويب متصفحك.