لماذا Markdown؟
النص العادي بلا هيكل يصعب قراءته على الموظف والعميل، ويصعب على المساعد استخراج الإجابة الصحيحة. Markdown يضيف عناوين، قوائم، وروابط بدون ترك المحرر إلى أدوات تنسيق معقّدة.
نعتبر Markdown لغة مشتركة بين الإنسان والذكاء: أنت تكتب المعنى والهيكل، والنظام يعرضه للزائر ويُفهرسه للمساعد. لذلك هي الطريقة الأنسب لمحتوى قاعدة المعرفة في كرزون — وليست «زخرفة اختيارية».

محرر Markdown بجانب المعاينة

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