إدخال Markdown

Markdown منسَّق

أمثلة تنسيق Markdown

Markdown المضغوط أو الفوضوي صعب القراءة؛ التنسيق يضيف مسافات بادئة وفواصل أسطر. مثال:

توثيق API

الإدخال المضغوط:

الإدخال

المخرجات المنسَّقة:

المخرجات

انقر على تحميل مثال أعلاه لتحميل مزيد من البيانات النموذجية.

ما هو منسق Markdown؟

Markdown لغة ترميز خفيفة لكتابة التوثيق وملفات README والمحتوى الإلكتروني. المسافات غير المتسقة والفواصل المختلطة أو القوائم الفوضوية تجعل Markdown صعب القراءة. يقوم منسق Markdown بتطبيع المسافات البادئة ومسافات القوائم والبنية لجعل المستند نظيفًا ومتسقًا. مواصفة CommonMark تحدد الصياغة.

تقوم هذه الأداة بتحليل Markdown وإعادة تنسيقه. تعمل بالكامل في المتصفح. لا يُرسَل شيء إلى الخادم. للتحويل إلى HTML استخدم Markdown إلى HTML. للتحقق من الصحة استخدم التحقق من Markdown.

كيفية استخدام هذه الأداة

1

الصق أو ارفع

انسخ Markdown الخاص بك والصقه في المحرر الأيسر. يمكنك أيضًا النقر على رفع الملف لتحميل ملف .md أو .markdown. يقوم زر تحميل مثال بتحميل بيانات نموذجية.

2

افحص المخرجات

يعرض اللوحة اليمنى Markdown المنسَّق. يتم تطبيع العناوين والقوائم وكتل الكود والروابط. قد يتم الاحتفاظ بالصياغة غير الصحيحة أو الغامضة كما هي.

3

انسخ أو نزّل

استخدم <strong>نسخ</strong> أو <strong>تنزيل</strong>. للمعاينة المباشرة استخدم محرر Markdown. لتوليد جدول المحتويات استخدم مولد فهرس Markdown.

متى يكون تنسيق Markdown مفيدًا

عند تحرير ملفات README على GitHub، أو توثيق على GitHub Docs، أو محتوى من مؤلفين متعددين، يعمل التنسيق على توحيد الأسلوب. المسافات البادئة غير المتسقة في القوائم أو أنماط العناوين المختلطة تجعل المستندات صعبة الصيانة. تمرير Markdown عبر هذه الأداة يوفر أساسًا نظيفًا. راجع صياغة Markdown الأساسية كمرجع.

المحتوى من تصديرات CMS أو النص المنسوخ من الإنترنت أو Markdown الذي يولده الذكاء الاصطناعي غالبًا ما يكون به مسافات فوضوية. تنسيقها هنا يحسن قابلية القراءة قبل الإيداع أو النشر. لمعاينة الصياغة استخدم مرجع Markdown.

الأسئلة الشائعة

هل بياناتي خاصة؟

نعم. التنسيق يعمل بالكامل في المتصفح. لا تُرسَل أي بيانات إلى أي خادم.

هل يدعم GitHub Flavored Markdown؟

يدعم المنسق Markdown الشائعة. يتم الاحتفاظ بامتدادات GFM (الجداول والنص المشطوب وقوائم المهام) عادةً. للتحقق الكامل من GFM راجع المخرجات.

ماذا عن كتل الكود؟

يتم الاحتفاظ بكتل الكود المسوّرة (علامات التنصيص الثلاثية) وكتل الكود ذات المسافة البادئة. يتم الحفاظ على معرّفات اللغة. يركز التنسيق على البنية وليس محتوى الكود.

هل يمكنني التحويل إلى HTML؟

نعم. استخدم Markdown إلى HTML لتحويل المخرجات المنسَّقة. سيعكس HTML البنية المنظفة.

هل يغيّر المعنى؟

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

أدوات ذات صلة

معرفة المزيد: CommonMark، مواصفة CommonMark، GitHub Flavored Markdown، Markdown Guide، GitHub، W3C HTML، GitHub Docs.