لماذا Markdown؟
النص العادي بلا هيكل يصعب قراءته على الموظف والعميل، ويصعب على المساعد استخراج الإجابة الصحيحة. Markdown يضيف عناوين، قوائم، وروابط بدون ترك المحرر إلى أدوات تنسيق معقّدة.
نعتبر Markdown لغة مشتركة بين الإنسان والذكاء: أنت تكتب المعنى والهيكل، والنظام يعرضه للزائر ويُفهرسه للمساعد. لذلك هي الطريقة الأنسب لمحتوى قاعدة المعرفة في كرزون — وليست «زخرفة اختيارية».
وسائط مطلوبة: محرر Markdown بجانب معاينة لنفس المقالة.
المسار المقترح:
المسار المقترح:
/images/help/knowledge-base/markdown-editor-preview.webpلماذا تتعلّمه الآن؟
- محرر قاعدة المعرفة يعتمد Markdown فقط كمصدر للمحتوى — راجع كتابة المقالة.
- مقالة منظّمة تُنشر أفضل للعميل وللمساعد من فقرة طويلة بلا عناوين — راجع الاستخدام مع الذكاء.
- نفس الرموز تعمل في كثير من أدوات الفريق والمساعدين؛ مهارة واحدة تخدم أكثر من شاشة.
قواعد سريعة قبل الأمثلة
- اكتب في المحرر داخل مجلد فئة، ثم استخدم معاينة من لوحة الخصائص.
- احفظ (⌘S / Ctrl+S) قبل الحكم على الشكل النهائي.
- للعربية: اكتب العناوين والجمل بالعربية؛ الأسطر العربية تُحاذى لليمين في المحرر تلقائياً.
- لا تلصق من Word/Docs بتنسيق مخفي — انسخ نصاً نظيفاً ثم أضف رموز Markdown بنفسك.
العناوين
العناوين تقسم المقالة إلى أقسام يقفز إليها القارئ ويستدل بها المساعد.التأكيد والتمييز
` أو بخط عريض حتى لا تختلط مع النص التشغيلي.
القوائم والخطوات
للخطوات المتسلسلة استخدم قائمة مرقّمة؛ للخيارات أو الشروط قائمة نقطية.الروابط والصور
![...]) يساعد الفهم إن لم تُحمَّل الصورة.
الجداول
مناسبة لمقارنة حالات، خطط، أو «افعل / لا تفعل».الاقتباس وكتل التعليمات
مثال مقالة جاهزة للنسخ
انسخ الهيكل التالي إلى مقالة جديدة وعدّل النصوص لعملك:وسائط مطلوبة: محرر يعرض المثال أعلاه ومعاينة بنفس الهيكل.
المسار المقترح:
المسار المقترح:
/images/help/knowledge-base/markdown-sample-article.webpكتابة تساعد المساعد
المساعد يعتمد على المقالات المنشورة. Markdown الجيد يزيد وضوح الاسترجاع:
بحث شريط المستكشف يبحث العناوين والمجلدات فقط — جودة Markdown لا تغني عن النشر، لكنها تجعل محتوى المعرفة أوضح حين يستدعيه المساعد.
أخطاء شائعة
وسائط مطلوبة (مستحسن): فيديو 30–45 ثانية — لصق المثال، معاينة، حفظ.
المسار المقترح:
المسار المقترح:
/images/help/knowledge-base/markdown-demo.mp4 أو تسجيل شاشة بنفس المشهد.