تدقيق Markdown
تحقق من أسلوب وبنية Markdown
أدخل Markdown
تقرير التدقيق
أمثلة تدقيق Markdown
يكشف المدقق عن مشكلات الأسلوب: الأسطر الطويلة، وقفز مستويات العناوين، وعلامات القوائم المختلطة. مثال:
Markdown مع مشكلات شائعة
سطر طويل، وقفز في العنوان (من H2 إلى H3 مع تخطي H1)، وعلامات قوائم مختلطة - و*.
الصقه في المحرر أعلاه لرؤية تقرير التدقيق. استخدم تحميل مثال لتحميل المزيد.
ما هو مدقق Markdown؟
Markdown لغة ترميز خفيفة للوثائق وملفات README والمحتوى على الويب. يتحقق المدقق من Markdown بحثًا عن مشكلات الأسلوب والبنية: مستويات العناوين غير المتسقة، والأسطر الفارغة المفقودة، والروابط المعطوبة، والتنسيق الذي قد لا يُعرض كما هو متوقع. تحدد مواصفات CommonMark وGitHub Flavored Markdown (GFM) بناء الجملة.
تعمل هذه الأداة بالكامل في المتصفح. يتم تحليل Markdown محليًا — لا يُرسل أي شيء إلى الخادم. يعرض تقرير التدقيق المشكلات حسب رقم السطر مع مستوى الخطورة (خطأ، تحذير، معلومات). لتنسيق Markdown استخدم منسق Markdown. للتحقق استخدم Markdown Validator.
كيفية استخدام هذه الأداة
الصق أو ارفع
الصق Markdown في المحرر الأيسر أو انقر على رفع الملف لتحميل ملف .md أو .markdown أو .txt. استخدم تحميل مثال لتحميل بيانات نموذجية بها مشكلات شائعة.
راجع تقرير التدقيق
تُظهر اللوحة اليمنى تقرير التدقيق بأرقام الأسطر والأوصاف. صحح المشكلات في المحرر الأيسر؛ يتحدث التقرير تلقائيًا. استخدم نسخ أو تنزيل لحفظ التقرير.
أصلح وأعد التدقيق
حل كل مشكلة وأعد التشغيل. لتحويل Markdown إلى HTML استخدم Markdown إلى HTML. لإنشاء جدول المحتويات من العناوين استخدم مولد فهرس Markdown.
متى يُساعد تدقيق Markdown
قبل إيداع الوثائق على GitHub أو النشر في نظام إدارة المحتوى، يكتشف التدقيق المشكلات التي قد تُفسد العرض أو تُربك القراء. التسلسل الهرمي غير المتسق للعناوين يجعل جداول المحتويات غير موثوقة. الروابط المرجعية المعطوبة تسبب أخطاء 404. تشغيل Markdown هنا يحسن الجودة قبل المراجعة.
تستفيد صفحات التوثيق وملفات README ومنشورات المدونة من Markdown المتسق. لتحويله إلى HTML استخدم Markdown إلى HTML. لإنشاء جدول المحتويات من العناوين استخدم مولد فهرس Markdown. للرجوع إلى بناء الجملة استخدم Markdown Cheat Sheet.
الأسئلة الشائعة
هل بياناتي خاصة؟
نعم. يعمل التدقيق بالكامل في المتصفح. لا يُرسل أي بيانات إلى أي خادم. يمكنك التحقق من ذلك بفتح علامة تبويب الشبكة في المتصفح.
ماذا يتحقق؟
تشمل الفحوصات الشائعة: اتساق العناوين، والأسطر الفارغة حول الكتل، وتنسيق القوائم، وصحة الروابط، والامتثال لـ CommonMark/GFM. تعتمد القواعد الدقيقة على التنفيذ.
المدقق مقابل المتحقق؟
يركز المدقق على الأسلوب وأفضل الممارسات. يتحقق المتحقق من صحة بناء الجملة. استخدم كليهما لضمان الجودة. جرب Markdown Validator للتحقق.
هل يدعم GFM؟
تدعم كثير من المدققات GitHub Flavored Markdown (الجداول، وقوائم المهام، والنص المشطوب). تحقق من التقرير بحثًا عن مشكلات خاصة بـ GFM.
هل يمكنه إصلاح المشكلات تلقائيًا؟
تُبلغ هذه الأداة عن المشكلات؛ أنت تُصلحها يدويًا. للتنسيق (المسافات البيضاء، وفواصل الأسطر) استخدم منسق Markdown.
الأدوات ذات الصلة
بناء جملة Markdown: CommonMark ومواصفة CommonMark. GitHub Flavored Markdown يوسعها. Markdown Guide يقدم دروسًا تعليمية. انظر أيضًا GitHub وW3C HTML وJekyll.