دليل كتابة المقالات في هذه المدوّنة

هذا المقال مرجع داخلي يعرض كل عناصر الكتابة المدعومة. اتركه مسودة، واستخدمه للمعاينة المحلية عند تعديل التصميم.

العناوين

استخدم ## للأقسام الرئيسية و### للأقسام الفرعية. عنوان المقال نفسه يأتي من الـ frontmatter، لذلك لا تستخدم # داخل المقال (وإن استخدمته سيتحول تلقائيًا إلى عنوان من المستوى الثاني).

عنوان فرعي

تظهر العناوين من المستويين الثاني والثالث تلقائيًا في «محتويات المقال».

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

نص عريض ونص مائل ومشطوب، ورابط إلى الموقع الشخصي، ورابط داخلي إلى صفحة البحث.

القوائم

• عنصر أول
• عنصر ثانٍ
  • عنصر متفرّع

1. الخطوة الأولى
2. الخطوة الثانية

• مهمة منجزة
• مهمة لم تُنجز بعد

الأكواد

كود داخل السطر مثل npm run build، وكتلة كود مع تلوين:

export function greet(name: string): string {
  return `مرحبًا ${name}`;
}

npm run validate

الاقتباسات والصناديق التوضيحية

اقتباس عادي يظهر بخط جانبي.

الجداول

الصور

ضع الصور في public/images/articles/<التصنيف>/ واكتب وصفًا حقيقيًا للصورة:

الهوامش

يمكن إضافة هامش بهذا الشكل¹.

الهوامش

1. هذا نص الهامش. ↩