محلل Markdown
حلّل واستعرض Markdown في الوقت الفعلي. يدعم جداول GFM وقوائم المهام والشطب والمزيد. جميع العمليات تتم في متصفحك.
ستظهر معاينة HTML هنا...
كيفية استخدام محلل Markdown
اكتب Markdown
اكتب أو الصق محتوى Markdown في المحرر على اليسار.
معاينة مباشرة
شاهد مخرجات HTML المعروضة في الوقت الفعلي في اللوحة اليمنى.
نسخ HTML
انسخ HTML المُنشأ لاستخدامها في مشاريعك.
ما هو Markdown؟
Markdown هي لغة ترميز خفيفة أنشأها جون غروبر في عام 2004. تستخدم بناء جملة تنسيق نص عادي يمكن تحويله إلى HTML والعديد من التنسيقات الأخرى. تُستخدم Markdown على نطاق واسع في التوثيق وملفات README ومنشورات المدونات ومنصات المراسلة.
بناء الجملة المدعوم
العناوين
من H1 إلى H6 باستخدام بناء جملة #
تنسيق النص
غامق ومائل ومشطوب وكود مضمن
القوائم والجداول
مرقمة وغير مرقمة وقوائم مهام وجداول GFM
كتل الكود
كتل كود مسيجة مع تمييز بناء الجملة
الأسئلة الشائعة
GFM (نكهة GitHub لـ Markdown) هي لهجة من Markdown تستخدمها GitHub. توسع Markdown القياسي بميزات مثل الجداول وقوائم المهام والنص المشطوب والروابط التلقائية.
يقوم المحلل بعرض كتل الكود المسيجة. لتمييز بناء الجملة الكامل بالألوان، يمكنك دمجه مع ورقة أنماط CSS تنسق عناصر الكود.
نعم! اكتب Markdown في المحرر وانسخ HTML المعروضة واستخدمها في توثيقك أو مدونتك أو موقعك.
ترك Markdown الأصلي (2004) العديد من الحالات الحدّية غير محددة، فتباينت التطبيقات في التعامل معها. CommonMark هو المواصفة الصارمة التي تحل هذه الحالات؛ أما GFM (GitHub Flavored Markdown) فهو CommonMark مع إضافات: الجداول وقوائم المهام والشطب والروابط التلقائية وفلتر disallowed-raw-HTML. تعرض هذه الأداة GFM، بما يطابق ما تراه على GitHub.
التفّ الكود المضمّن بعلامة backtick واحدة من كل جانب. تستخدم الكتل المسوّرة (fenced blocks) ثلاث علامات backtick مع وسم لغة لتمييز الصياغة - مثل ```python في السطر الافتتاحي - أو أزح كل سطر بأربع مسافات (الصياغة الأقدم، التي تتفاعل بشكل سيئ داخل القوائم). تعمل ثلاث علامات ~ المتتالية أيضاً كمسوّر عندما يحتوي الكود نفسه على علامات backtick.
نعم - تمر وسوم HTML المضمّنة إلى المخرجات كما هي. امتداد disallowed-raw-HTML في GFM يزيل فقط بعض الوسوم الخطرة (script وstyle وiframe ونحوها) عند تمكين الفلتر. ملاحظتان: HTML على مستوى الكتلة يحيط بمحتوى تتوقف معالجة صياغة Markdown داخله (الأسطر الفارغة مهمة هنا)، وأي Markdown يرسله المستخدمون يجب تعقيمه ضد XSS بما يتجاوز فلتر الوسوم.
صفوف مفصولة بالشرطة العمودية مع سطر فاصل من الشرطات تحت الترويسة. النقطتان تحددان المحاذاة: نقطة-شرطة على اليسار تعني محاذاة إلى اليسار (الافتراضي)، والنقطتان عند الطرفين تعني التوسيط، وشرطة-نقطة تعني المحاذاة إلى اليمين. لا يمكن أن تحتوي الخلايا على عناصر كتلية؛ واهرب الشرطة العمودية الحرفية كـ \|؛ أما الأنابيب الخارجية في كل صف فاختيارية. التخطيطات الأكثر تعقيداً تحتاج HTML خام أو محرك توثيق.
المسببات المعتادة: مسافات بادئة غير متسقة (تحتاج العناصر المتداخلة عادةً إلى المحاذاة مع أول محرف من محتوى العنصر الأب)، أو غياب سطر فارغ بين فقرة وقائمة، أو خلط علامات الجدولة (tabs) مع المسافات. تحدد CommonMark قواعد دقيقة لكل هذه الحالات. تحويل علامات الجدولة إلى مسافات وإضافة أسطر فارغة حول القوائم يحل الغالبية العظمى من مشكلات التداخل.
الأدوات ذات الصلة
المراجع المعتمدة
المصادر الأساسية وراء هذه الأداة - معايير ومواصفات رسمية، وليست ملخصات منقولة عن الغير.