🚀 بداية سريعة

ألصق المحتوى في خانة الإدخال اليسرى
اختر الوضع (→HTML أو →Markdown)
يتم التحويل تلقائيًا، والنتيجة تظهر على اليمين
المعاينة/مخرجات HTML: في Markdown → HTML يتم عرض KaTeX/Mermaid افتراضيًا
قد تُفعَّل معاينة مخفّفة للمدخلات الكبيرة جدًا (تقييد العرض/تعطيل الإبراز)

📌 سيناريوهات شائعة

مدونات/وثائق: فحص سريع للمخرجات والألوان
البريد: لصق HTML المُصدَّر في نص الرسالة (ويُفضَّل الأنماط المضمّنة)
نص منسق → Markdown: تنظيف نصوص الويب/CMS لتتبعها بالإصدارات
توثيق تقني: عرض المعادلات/الرسومات وتصديرها بخطوة واحدة
ترحيل المحررات: التوفيق بين لهجات Markdown المختلفة
ويكي/قاعدة معرفة: تحويل صفحات HTML إلى Markdown للاستيراد
سجل تغييرات API: تحويل HTML/الأوصاف إلى Markdown للمراجعة/PR

🧭 نصائح الاستخدام

Markdown → HTML: يجري عرض KaTeX/Mermaid تلقائيًا
HTML → Markdown: نُبقي/نستعيد الشيفرة الأصلية دون عرض ثانٍ
ندعم GFM (جداول/قوائم مهام) افتراضيًا؛ للالتزام الصارم بـ Markdown استخدم الصياغة القياسية
نفعل فواصل الأسطر افتراضيًا؛ للسلوك الصارم افصل بسطور فارغة أو أضف مسافتين في نهاية السطر
البريد الإلكتروني: استخدم أنماطًا مضمنة لتحسين التوافق
النصوص الطويلة: حوِّل على دفعات لتفادي البطء

⚠️ القيود والتوافقية

اختلاف اللهجات: تختلف نواتج العرض بين المنصات؛ التزم بالصيغ الشائعة
HTML → Markdown محاولة استعادة؛ غالبًا تُفقد الأنماط/التخطيط
في HTML → Markdown تُتجاهل بعض الوسوم/الخصائص (script/style/meta/base، iframe/object/embed، عناصر النماذج، الوسائط، أحداث on*، و style/class…)
قد تُبسّط الجداول المعقدة/المتداخلة؛ راجع الناتج
الصور/الفيديو تُترك كرابط خارجي ولا تُحمّل
رسوم Mermaid بصيغة SVG المعروضة من أطراف خارجية غالبًا لا تُستعاد

🔒 الخصوصية والأمان

تتم جميع المعالجة داخل متصفحك؛ ولا تغادر بياناتك جهازك
لا يشغّل وسوم <script> داخل HTML الملصوق
يُعرض KaTeX/Mermaid بإعدادات آمنة
لا نقوم بتنقية HTML بالكامل تلقائيًا؛ يُرجى المراجعة قبل/بعد التحويل

❓ أسئلة شائعة

المعاينة تختلف عن منصة النشر — كيف أشخّص المشكلة؟

حدّد لهجة Markdown المستهدفة (CommonMark/GFM/مخصّصة). تجنّب HTML الخام والامتدادات الخاصة. استخدم فواصل معيارية (سطر فارغ أو مسافتان في نهاية السطر). ابدأ بمثالٍ مصغّر تحقّقه على المنصة ثم وسّع النطاق.

كيف أنشر HTML المُصدَّر بشكل آمن في الإنتاج؟

الأداة لا تُشغّل <script> لكنها لا تنظّف تلقائيًا. نفّذ التنقية في الخادم/خطّ النشر باستخدام مكتبة قائمة بيضاء (مثل DOMPurify)، واحظر on* والبروتوكولات الخطِرة، وطبّق CSP لتقييد السكربتات الخارجية/المضمّنة.

HTML → Markdown يشوّه البُنى المعقدة — ما الحل؟

اعتمد دلالات قابلة للنقل: حوّل الجداول/القوائم المتداخلة إلى جداول Pipe وقوائم أبسط؛ ألصق كنص عادي لإزالة span/style/class قبل التحويل؛ اعزل مثالًا مصغّرًا وعدّل المصدر تبعًا لذلك.

قيود KaTeX/Mermaid وكيفية استكشاف الأعطال؟

الصياغة: KaTeX بـ $$…$$ أو داخل السطر $…$؛ وMermaid داخل كتلة ```mermaid. قد تُخفَّف المدخلات الكبيرة (عرض الشيفرة/تعطيل الإبراز). خفّض الكثافة وقسّم التحويل واستخدم أمثلة مصغّرة. الاستعادة: KaTeX من HTML المعروض؛ وMermaid فقط للرسوم المنشأة بهذه الأداة والمرفقة بالشيفرة.