ما هي معاينة Markdown؟
Markdown هو صيغة التنسيق الخفيفة وراء ملفات README ومنشورات المدونة ورسائل الدردشة والتوثيق. لأنه نص عادي، يسهل الكتابة في أي مكان.
يعرض هذا العارض Markdown أثناء الكتابة، جنباً إلى جنب مع المصدر، لتمكينك من التقاط أخطاء التنسيق فوراً.
متى تستخدم هذه الآلة الحاسبة
- كتابة README على GitHub والتحقق من التنسيق قبل الإيداع
- إنشاء مسودة منشور Markdown لمدونة أو توثيق
- التحقق من عرض بريد إلكتروني Markdown بشكل صحيح
- تعلم صيغة Markdown بالتجربة
- تحويل مقتطف Markdown قصير إلى HTML
- تصحيح مستند Markdown حيث لا يعرض بعض التنسيق
الخطوات:
- اكتب أو الصق Markdown في اللوحة اليسرى.
- شاهد معاينة HTML المعروضة تتحدث فوراً على اليمين.
- اضبط الصيغة حتى تتطابق المعاينة مع ما تقصده.
- انسخ مصدر Markdown الخاص بك عندما تكون راضياً عن النتيجة.
الصيغة
حالات الاستخدام
- معاينة README على GitHub أو GitLab قبل الإيداع
- إنشاء مسودات رسائل منسقة لـ Slack أو Discord
- التحقق من تنسيق منشور المدونة أو التوثيق قبل النشر
- تعلم صيغة Markdown بالتجربة ورؤية النتائج الفورية
- تحويل مقتطف Markdown قصير إلى HTML للصق في مكان آخر
الفوائد الرئيسية
- شاهد Markdown معروضاً فوراً، جنباً إلى جنب مع المصدر
- التقاط أخطاء الصيغة قبل النشر
- يعمل بالكامل دون اتصال في متصفحك
- مجاني، بدون تسجيل، بدون حدود حجم ملف
نصائح احترافية
- أضف سطر فارغاً قبل وبعد القوائم وبلوكات الكود لأكثر العرض موثوقية.
- استخدم نجمتين للغامق ونجمة واحدة للمائل.
- معاين هنا أولاً، ثم تحقق من المنصة المستهدفة.
- أبقِ العناوين متسلسلة (لا تتخطى من # إلى ###).
الأخطاء الشائعة التي يجب تجنبها
- نسيان السطر الفارغ المطلوب بين الفقرة والقائمة التالية
- نقص المسافة بعد رموز # في العناوين
- ترك بلوك الكود (```) غير مغلق
- استخدام نجمة واحدة للغامق بدلاً من نجمتين
شرح المصطلحات الأساسية
- CommonMark: مواصفة موحّدة لصيغة Markdown، صُممت لتقليل التناقضات
- GFM: GitHub-Flavored Markdown، لهجة موسعة تدعم الجداول وقوائم المهام.
- كتلة الشيفرة (Code fence): كتلة محددة بعلامات اقتباس عكسية ثلاثية (```) تُستخدم لتنسيق الشيفرة متعددة الأسطر
- تنسيق مضمن: تنسيق مطبق داخل سطر واحد.
مفاهيم ذات صلة
- منسق JSON:
- فاحص النمط المنتظم:
- مولّد كلمات المرور:
- محوّل الألوان:
- مشفر/مفكك URL:
مثال
كتابة "## Hello
This is **bold** and this is *italic*." تُعرض كعنوان من المستوى الثاني يليه فقرة بنص غامق ومائل.
تفسير نتائجك
تعرض اللوحة اليسرى نص Markdown الخام، واللوحة اليمنى تعرضه كـ HTML منسق.
مشاكل العرض الشائعة تتعلق عادة بالمسافة.
المعاينة تقريبية لكيفية ظهور Markdown على معظم المنصات.