Skip to main content

كيفية استخدام Markdown (CommonMark) في ويكي لدينا

ملاحظة: هذا المستند هو ترجمة آلية للنسخة الإنجليزية الأصلية.

كيفية استخدام Markdown (CommonMark) في الويكي الخاص بنا

هذه الصفحة عبارة عن "ورقة غش" قصيرة لتنسيق الصفحات في الويكي الخاص بنا، حيث تتم كتابة المحتوى بتنسيق CommonMark Markdown.

القواعد الأساسية

  • اكتب بجمل بسيطة وقصيرة.
  • اجعل الصفحة قابلة للمسح الضوئي (سهلة القراءة السريعة): العناوين + القوائم + الجداول.
  • قسم واحد = فكرة واحدة. تجنب "الجدران النصية" (النصوص الطويلة المتصلة).

العناوين

استخدم ## / ### / #### للهيكلة.

## قسم
### قسم فرعي
#### قسم فرعي أصغر

غامق، مائل، كود مضمّن

**غامق**
*مائل*
`كود/حقل/عنوان`

الروابط

[نص الرابط](https://example.com)

إذا كنت بحاجة إلى إظهار رابط "خام" (نادر):

`https://example.com`

القوائم

قائمة نقطية:

- عنصر 1
- عنصر 2
  - عنصر فرعي

قائمة مرقمة:

1. خطوة 1
2. خطوة 2
3. خطوة 3

الاقتباسات / الملاحظات

> هذه ملاحظة مهمة.
> يمكن أن تتكون من سطرين.

الجداول

النموذج الأدنى:

| الحقل | القيمة |
|---|---|
| الاسم | [ ] |
| الحالة | [ ] |

نصائح:

  • الصف الفاصل |---|---| مطلوب.
  • يمكن أن تحتوي خلايا الجدول على **غامق** وروابط و كود.

كتل التعليمات البرمجية (الكود) والنصوص "الخام"

كتلة الكود:

\```text
السطر 1
السطر 2
\```

إذا كانت لغة معينة (على سبيل المثال، JSON)، يمكنك تحديدها:

\```json
{ "key": "value" }
\```

الصور

إذا كان لديك رابط (URL) مباشر للصورة:

![الوصف](https://example.com/image.png)

إذا تم تحميل الملف إلى الويكي، فاستخدم الرابط/كود التضمين الذي يوفره الويكي عند التحميل.

فواصل الأسطر والفقرات

  • الفقرة الجديدة هي سطر فارغ بين الفقرات.
  • إذا كنت بحاجة إلى فاصل أسطر داخل فقرة، أضف مسافتين في نهاية السطر:
السطر الأول.  
السطر الثاني.

HTML المضمن (استخدمه بحذر)

كتلة "التفاصيل" القابلة للطي

استخدمها للتفاصيل/الأدلة الطويلة لتجنب إثقال "الشاشة الأولى".

<details>
<summary><b>التفاصيل</b></summary>

يمكنك وضع النصوص والقوائم والجداول هنا.

</details>

الروابط الداخلية (Anchors) والروابط السريعة داخل الصفحة

الرابط الداخلي (Anchor):

<a id="ai-thesis-fit"></a>

الرابط إلى الرابط الداخلي:

[انتقل إلى مدى التوافق مع أطروحة الذكاء الاصطناعي](#ai-thesis-fit)

العناصر النائبة (Placeholders) في النماذج

في النماذج نستخدم:

  • [ ] — "املأ"
  • / — "— / لا ينطبق" (عندما يكون ذلك منطقياً)
  • YYYY‑MM‑DD — تنسيق التاريخ
  • Tier‑1/2/3 — مستوى المصدر (أدلة/سياق/ضوضاء)

الأخطاء الشائعة

  • الخلط بين صندوق المعلومات (infobox) والوصف: صندوق المعلومات مخصص للحقائق القصيرة فقط؛ بينما توضع التفسيرات في صلب الصفحة.
  • الكتابة بدون مصادر في مكان يجب أن يوجد فيه مصدر.
  • إثقال "الشاشة الأولى": من الأفضل وضع التفاصيل الطويلة داخل <details>.
  • استخدام "لغة مالية" (نصائح الشراء/البيع/الاحتفاظ، التوقعات) — هذا محظور بالنسبة لنا؛ نحن نكتب الحقائق/المخاطر/ما يجب التحقق منه.

قائمة تحقق مصغرة قبل النشر

  • هل يوجد سطر أو سطران يشرحان "ما هو"؟
  • هل توجد روابط للمصادر الأولية؟
  • هل توجد أي حقول جدول فارغة "غير واضحة" (يجب أن يكون كل حقل إما قيمة أو —/—
  • هل تم ملء Last verified (آخر تحقق)؟