كيفية تحويل HTML إلى Markdown
- قم بلصق جزء من HTML أو تحميل ملف
.htmlمدعوم. - قم بتحويل المصدر ومراجعة العناصر الدلالية التي تظل ذات معنى في Markdown.
- قم بتحويل وفحص الروابط والصور والقوائم المتداخلة والجداول والتعليمات البرمجية.
- انسخ Markdown أو قم بتنزيل ملف
.md.
ماذا يحفظ المحول؟
| محتوى المصدر | سلوك الإخراج الموصى به | ملاحظة التحويل |
|---|---|---|
| العناوين | ربط <h1>–<h6> بعناوين Markdown | |
| الفقرات والتوكيد | تحويل الفقرات، النص العريض والتوكيد | |
| القوائم | تحويل القوائم المرتبة وغير المرتبة والمتداخلة | |
| الروابط | الحفاظ على النص ورابط URL الذي تم حله | |
| الصور | الحفاظ على المصدر والنص البديل | |
| الرموز والتعليمات البرمجية | استخدام التعليمات البرمجية المضمنة والكتل المسورة | |
| الجداول | تحويل الجداول المتوافقة إلى GFM | |
| الاقتباسات | تحويل الاقتباسات الدلالية |
ما الذي قد يتغير أثناء التحويل؟
البرامج النصية والأنماط والنماذج
العناصر القابلة للتنفيذ والتفاعلية ليس لها مكافئ عادي في Markdown وقد يتم حذفها أو تقليلها إلى نص.
الجداول المعقدة
قد تحتاج امتدادات الصفوف وامتدادات الأعمدة والجداول المتداخلة ومحتوى الخلايا الغني إلى HTML خام أو تسطيح.
روابط URL النسبية
قد لا يتضمن الجزء الملصق عنوان URL الأساسي للصفحة، لذلك لا يمكن دائمًا حل الروابط النسبية ومسارات الصور.
حاويات التخطيط
تخطيطات div والشبكة و flexbox لا تعني ترتيب قراءة دلالي.
المحتوى المخفي والنمطي
يحتاج المحول إلى سياسة واضحة للعناصر المخفية والتنقل والمحتوى المنهار بصريًا.
الاستخدامات الشائعة لتحويل HTML إلى Markdown
ترحيل توثيق الويب
نقل HTML الدلالي إلى نظام توثيق يعتمد على Markdown.
تنظيف النصوص المنسقة المنسوخة
تحويل HTML الناتج عن المحرر إلى تنسيق أبسط قبل إصداره أو نشره.
إعداد أمثلة التعليمات البرمجية
الاحتفاظ بكتل التعليمات البرمجية والعناوين دون نقل ورقة أنماط الصفحة الكاملة.
إنشاء سياق ذكاء اصطناعي يركز على النص أولاً
إزالة البرامج النصية والتنسيقات مع الاحتفاظ بهيكل المعلومات الذي لا يزال يتعين مراجعته.
مثال على تحويل HTML إلى Markdown
<h2>Setup</h2>
<p>Read the <a href="/guide">guide</a>.</p>
<ul><li>Install</li><li>Test</li></ul>## Setup
Read the [guide](/guide).
- Install
- Testنصائح للحصول على إخراج Markdown أنظف
- استخدام HTML دلالي تتحول العناوين والقوائم والجداول بشكل أكثر موثوقية من حاويات التخطيط العامة.
- توفير عنوان URL أساسي عند الحاجة تتطلب الروابط النسبية سياقًا إذا كان من المفترض أن تعمل النتيجة خارج الصفحة الأصلية.
- اختيار لهجة الإخراج يدعم GFM الجداول وقوائم المهام التي لا يحددها CommonMark الأساسي.
- مراجعة كتل التعليمات البرمجية تأكيد لغة البرمجة المكتشفة وأي علامات اقتباس خلفية مدمجة.
- تحديد الخيار البديل لـ raw-HTML قد يحافظ الاحتفاظ بـ HTML غير المدعوم على المعلومات ولكنه يقلل من إمكانية النقل.
الأسئلة الشائعة
هل تتم إزالة عنصري <script> و <style>؟
البرامج النصية والأنماط ليست محتوى Markdown مفيدًا ولا ينبغي الاعتماد عليها في النتيجة. راجع HTML الملصق قبل إعادة استخدام الإخراج.
هل يتم تحويل جداول HTML إلى جداول Markdown؟
يمكن أن تصبح الجداول المستطيلة المتوافقة جداول GFM. الجداول التي تحتوي على rowspan أو colspan أو كتل متداخلة أو صفوف رأس متعددة تحتاج إلى خيار بديل موثق.
هل يتم حفظ كتل التعليمات البرمجية والتعليمات البرمجية المضمنة؟
يمكن تعيينها من <pre> و <code>.
ماذا يحدث للروابط والصور؟
قد يتم الاحتفاظ بنص الرابط والوجهات الصالحة. تظل الروابط النسبية ومسارات الصور معتمدة على السياق لأن الجزء المرفوع ليس له عنوان URL أساسي مضمون.
هل تتم إزالة علامات HTML غير المدعومة أم الاحتفاظ بها؟
قد يتم تبسيط أغلفة العرض فقط مع الاحتفاظ بالنص المقروء. قارن المخرجات بالمصدر عندما تحمل العناصر المخصصة معنى.
هل يقوم المحول بإخراج CommonMark أم GFM؟
الإخراج المقصود هو GitHub-Flavored Markdown. تعتمد الجداول والخط المشطوب وقوائم المهام على امتدادات GFM.
هل يمكنني لصق مستند HTML كامل؟
نعم. يمكنك لصق جزء أو تحميل ملف .html أو .htm، ثم مراجعة Markdown الناتج.
هل يمكن لهذه الصفحة تحويل عنوان URL لموقع ويب مباشر؟
لا. تقبل هذه الصفحة HTML الملصق أو ملف HTML المرفوع؛ ولا تجلب عنوان URL لموقع ويب مباشر.
تحويل Markdown مرة أخرى إلى PDF
هل لديك بالفعل ملف Markdown؟ استخدممحول Markdown إلى PDFلإنشاء ملف PDF قابل للمشاركة.