تحويل HTML محررات WYSIWYG إلى Markdown نظيف — يدعم 6 محررات
تنتج محررات النص المنسق HTML مليئاً بالترميز الخاص بكل محرر — فئات مملوكة وسمات بيانات وأنماط مضمنة وعناصر تغليف. يرتبط HTML هذا بمحرر ونظام إدارة محتوى محددين. Markdown هو العكس: تنسيق نص عادي قابل للنقل عبر أي منصة، قابل للقراءة بشكله الخام، ويعمل بشكل مثالي مع أنظمة التحكم بالإصدارات (فروق Git نظيفة وذات معنى).
ينتقل المطورون وفرق المحتوى إلى Markdown لثلاثة أسباب: قابلية النقل (نقل المحتوى بين المنصات دون إعادة تنسيق)، وتجربة المطور (كتابة التوثيق إلى جانب الكود في نفس المحرر)، والحماية من التقادم (Markdown من عام 2004 لا يزال يُعرض بشكل مثالي اليوم؛ HTML المرتبط بمحرر من 2018 قد لا يعمل).
| المحرر | المستخدم من قبل | خصائص HTML | صعوبة الترحيل |
|---|---|---|---|
| TinyMCE | WordPress Classic، Joomla، Drupal | فئات mce-*، سمات data-mce-*، يغلف المحتوى في <p> | سهل |
| CKEditor 4/5 | Drupal، Magento، تطبيقات مخصصة | فئات cke_*، غلاف صورة <figure>، تضمين <oembed> | سهل–متوسط |
| Quill | تطبيقات الويب الحديثة، محررات بنمط Notion | فئات ql-*، .ql-indent-N، .ql-align-*، <span> متداخلة للتنسيق | متوسط |
| WordPress Gutenberg | WordPress 5.0+ | تعليقات <!-- wp:paragraph -->، فئات wp-block-*، فئات مساعدة has-* | متوسط |
| UEditor (Baidu) | أنظمة إدارة محتوى صينية، تطبيقات مؤسسية | فئات list-paddingleft-*، سمات مخصصة _src، إزالة وسوم style | سهل |
الخطوة 1 — التصدير. استخرج محتوى HTML من نظام إدارة المحتوى أو المحرر الحالي. لـ WordPress، استخدم أداة التصدير المضمنة. للتطبيقات المخصصة، استعلم من قاعدة البيانات مباشرة. احفظ ملفات HTML الخام — لا تعدل أي شيء بعد.
الخطوة 2 — الاختيار والتحويل. اختر محررك من القائمة المنسدلة أعلاه لتفعيل قواعد التنظيف الخاصة بكل محرر. الصق HTML كل مقالة وانسخ مخرَج Markdown. يزيل المحول فئات mce-* وcke_* وql-* وwp-block-* تلقائياً.
الخطوة 3 — التحقق. راجع Markdown المحول عينياً. يجب أن تستخدم الصور صيغة . يجب أن تكون القوائم ذات مسافة بادئة متناسقة. يجب أن تستخدم كتل الكود محددات ``` مسيجة. يجب أن تعرض الجداول بشكل صحيح في معاينة Markdown.
الخطوة 4 — الاستيراد. أسقط ملفات .md في مولد موقعك الثابت (Hugo، Jekyll، Astro، Next.js، VitePress). أضف واجهة بيانات أمامية في أعلى كل ملف للعنوان والتاريخ والوسوم.
Markdown ليس دائماً الخيار الصحيح. إذا كان محتواك يعتمد على تخطيطات جداول معقدة (colspan/rowspan)، أو تضمينات HTML مخصصة، أو تنسيق مضمن دقيق، فسيفقد التحويل الدقة. في هذه الحالات، احتفظ بـ HTML واستخدم نظام إدارة محتوى يعرض HTML الخام إلى جانب Markdown — معظم مولدات المواقع الثابتة تدعم كليهما.
اختر نوع المحرر من القائمة المنسدلة، انتقل إلى عرض المصدر/HTML في محررك، انسخ HTML الخام، والصقه هنا. يزيل المحول الترميز الخاص بكل محرر (فئات mce-* من TinyMCE، وفئات cke_* من CKEditor، وفئات ql-* من Quill، وتعليقات كتل WordPress، وفئات المسافات البادئة من UEditor) وينتج Markdown نظيفاً.
TinyMCE وCKEditor 4/5 وQuill ومحرر كتل WordPress (Gutenberg) والمحرر الكلاسيكي وUEditor (Baidu) وHTML عام/غير معروف. لكل منها قواعد تنظيف مخصصة. إذا لم يكن محررك مدرجاً، لا يزال 'HTML عام' ينتج نتائج جيدة باستخدام تحويل Turndown.js القياسي.
نعم. اختر 'WordPress' من قائمة المحرر. يزيل المحول تعليقات الكتل <!-- wp:... --> وفئات wp-block-* والأنماط المضمنة من مخرجات Gutenberg والمحرر الكلاسيكي. يعمل Markdown الناتج مباشرة مع Hugo وJekyll وAstro ومولدات المواقع الثابتة الأخرى.
تأكد من اختيار المحرر الصحيح من القائمة المنسدلة. لكل محرر قواعد تنظيف محددة. إذا اخترت 'HTML عام'، لا يتم تطبيق أي تنظيف خاص بمحرر. انتقل إلى محررك الفعلي وسيقوم المحول بإزالة ترميزه المملوك.
Pandoc أداة قوية بسطر الأوامر لكنها لا تعرف الترميز الخاص بكل محرر — لا يمكنها إزالة فئات mce-item من TinyMCE أو سمات ql-indent من Quill. تضيف هذه الأداة معالجة مسبقة واعية بالمحرر قبل تحويل HTML إلى Markdown، وتعمل في متصفحك بدون أي إعداد.
تتحول الصور إلى صيغة ، مع الحفاظ على سمتي src وalt الأصليتين. تتحول الوسائط المضمنة (oEmbed، iframes) إلى رابط Markdown يشير إلى عنوان URL للوسائط. قد تحتاج إلى استبدال الروابط المؤقتة أو روابط CDN يدوياً بمسارات الصور النهائية بعد الترحيل.