دليل معاينة ماركداون و سير العمل الكتابي ٢٠٢٦: معيار CommonMark 0.31 و ١٤ إضافة GFM (الجداول و قوائم المهام و الشطب و الكتل التنبيهية) و مخططات Mermaid 11 و MathJax 4 + الاختلافات بين نكهات المولدات الثابتة الستة: Next.js و Hugo و Astro و Jekyll و Docusaurus و MkDocs
مرجع كامل لمؤلفي المحتوى حول ماركداون. تحديث معيار CommonMark 0.31 عام 2024: ٢٤٧ حالة اختبار مرجعية و قواعد تداخل التأكيد (لماذا تعمل الصيغة ***خط عريض مائل*** بينما تفضل ٩٢٪ من أدلة الأسلوب الصيغة **_خط عريض مائل_**) و فواصل الأسطر الصلبة (مسافتان في نهاية السطر مقابل الفاصلة المائلة في GFM). ١٤ إضافة GFM لا يمكن الاستغناء عنها: الجداول (محاذاة بنقطتين :---:) و قوائم المهام (- [x] منجز، يتطلب المعيار وجود مسافة بعد القوسين → ٤٣٪ من الكتاب يتخطونها فيعرض القوسين حرفياً) و الشطب (~~نص~~) و الارتباطات التلقائية لعناوين www. المفتوحة - لا تدعمها CommonMark الأساسية - و تعقيم HTML غير المسموح به وإزالة الوسوم النصية و عناصر iframe و أحداث النقر و الحواشي السفلية [^1] و كتل التنبيهات أنواعها الخمسة [!NOTE][!TIP][!IMPORTANT][!WARNING][!CAUTION] - مدعومة في جيت هاب منذ ٢٠٢٣. ورقة مرجعية لصيغ Mermaid 11 لثمانية أنواع من المخططات: التدفق و المتتالي و الفئات و الحالات و العلاقات ER و الجانت و الدائري و رحلة المستخدم. معادلات MathJax 4 في السطر $E=mc^2$ و في الكتل $$int_0^1 x dx$$. بالإضافة إلى الاختلافات بين المولدات الثابتة الستة: Next.js MDX يسمح بإدراج مكونات React داخل ملفات .mdx لكنه لا يتعرف على كتل التنبيهات GFM ما لم يثب remark-gfm؛ و أكواد هوجو القصيرة {{< tweet >}} تتعارض مع MDX؛ و Astro يدمج محرك التمييز Shiki مقابل محركات Prism في Docusaurus و Pygments في MkDocs و Rouge في Jekyll.
١. مقارنة CommonMark 0.31 و GFM - مصفوفة الميزات الدقيقة (اطبعها)
- ✅ خاص حصرياً لـ GFM #1 - خانات مهام التدقيق:
- [x] إطلاق الميزة. يعرضها CommonMark كقائمة نقطية عادية. قاعدة GFM: يجب أن يوجد مسافة واحدة بعد القوس المفتوح؛ الصيغة- [x]إطلاقينساها ٤٣٪ من الكتاب → تظهر القوسين حرفياً [x]. - ✅ خاص حصرياً لـ GFM #2 - الشطب:
~~مهجور~~. لا تدعم CommonMark صيغة الشطب و تستخدم وسم HTMLالذي غالباً ما تزيله المولدات الثابتة لسياسات الأمان. - ✅ خاص حصرياً لـ GFM #3 - محاذاة الجداول بالأنابيب: رأس الجدول ثم سطر المحاذاة :--- لمحاذاة اليسار و :---: للوسط و ---: لليمين. لا يدعم CommonMark الجداول أصلاً.