Skip to main content
Markdown لغة بسيطة تكتب بها مقالاتك في كرزون: يقرأها الإنسان بسهولة، ويعرضها الموقع بوضوح، ويفهمها المساعد عند الإجابة من قاعدة المعرفة. تعلّمها مرة، واستخدمها في كل مقالة.

لماذا Markdown؟

النص العادي بلا هيكل يصعب قراءته على الموظف والعميل، ويصعب على المساعد استخراج الإجابة الصحيحة. Markdown يضيف عناوين، قوائم، وروابط بدون ترك المحرر إلى أدوات تنسيق معقّدة. نعتبر Markdown لغة مشتركة بين الإنسان والذكاء: أنت تكتب المعنى والهيكل، والنظام يعرضه للزائر ويُفهرسه للمساعد. لذلك هي الطريقة الأنسب لمحتوى قاعدة المعرفة في كرزون — وليست «زخرفة اختيارية».
وسائط مطلوبة: محرر Markdown بجانب معاينة لنفس المقالة.
المسار المقترح: /images/help/knowledge-base/markdown-editor-preview.webp

لماذا تتعلّمه الآن؟

  • محرر قاعدة المعرفة يعتمد Markdown فقط كمصدر للمحتوى — راجع كتابة المقالة.
  • مقالة منظّمة تُنشر أفضل للعميل وللمساعد من فقرة طويلة بلا عناوين — راجع الاستخدام مع الذكاء.
  • نفس الرموز تعمل في كثير من أدوات الفريق والمساعدين؛ مهارة واحدة تخدم أكثر من شاشة.
لا تحتاج أن تصبح مطوّراً: بضعة رموز كافية لـ ٩٠٪ من مقالات الدعم والسياسات.

قواعد سريعة قبل الأمثلة

  1. اكتب في المحرر داخل مجلد فئة، ثم استخدم معاينة من لوحة الخصائص.
  2. احفظ (⌘S / Ctrl+S) قبل الحكم على الشكل النهائي.
  3. للعربية: اكتب العناوين والجمل بالعربية؛ الأسطر العربية تُحاذى لليمين في المحرر تلقائياً.
  4. لا تلصق من Word/Docs بتنسيق مخفي — انسخ نصاً نظيفاً ثم أضف رموز Markdown بنفسك.

العناوين

العناوين تقسم المقالة إلى أقسام يقفز إليها القارئ ويستدل بها المساعد.

التأكيد والتمييز

في مقالات كرزون: ضع أسماء الأزرار والحقول بين ` أو بخط عريض حتى لا تختلط مع النص التشغيلي.

القوائم والخطوات

للخطوات المتسلسلة استخدم قائمة مرقّمة؛ للخيارات أو الشروط قائمة نقطية.

الروابط والصور

داخل حساب كرزون: اربط الصفحات ذات الصلة بروابط مساعدة حقيقية، وضع الصور من مرفقات المقالة أو مدير الملفات عندما يناسب سير عملك — الوصف البديل (![...]) يساعد الفهم إن لم تُحمَّل الصورة.

الجداول

مناسبة لمقارنة حالات، خطط، أو «افعل / لا تفعل».

الاقتباس وكتل التعليمات

استخدم الاقتباس لتحذير قصير؛ والكتلة ذات الخلفية لنصوص ثابتة (أكواد تتبع، صيغ رد) حتى لا تُفسَّر كفقرات عادية.

مثال مقالة جاهزة للنسخ

انسخ الهيكل التالي إلى مقالة جديدة وعدّل النصوص لعملك:
بعد اللصق: استبدل الروابط، انشر عندما تراجع — راجع الحالات والنشر.
وسائط مطلوبة: محرر يعرض المثال أعلاه ومعاينة بنفس الهيكل.
المسار المقترح: /images/help/knowledge-base/markdown-sample-article.webp

كتابة تساعد المساعد

المساعد يعتمد على المقالات المنشورة. Markdown الجيد يزيد وضوح الاسترجاع: بحث شريط المستكشف يبحث العناوين والمجلدات فقط — جودة Markdown لا تغني عن النشر، لكنها تجعل محتوى المعرفة أوضح حين يستدعيه المساعد.

أخطاء شائعة

وسائط مطلوبة (مستحسن): فيديو 30–45 ثانية — لصق المثال، معاينة، حفظ.
المسار المقترح: /images/help/knowledge-base/markdown-demo.mp4 أو تسجيل شاشة بنفس المشهد.

ذات صلة

آخر تعديل في ١٥ أغسطس ٢٠٢٦