## المرجع

تنبيهات GitHub Markdown

نشر مارس 2026

أضاف GitHub صيغة التنبيهات إلى GitHub Flavored Markdown. هذه الصناديق الملوّنة تبرز المعلومات المهمة في التوثيق، مثل الملاحظات والنصائح والتحذيرات. ShowMeMyMD من بين الأدوات القليلة التي تعرضها محليا.

## الصيغة

خمسة أنواع

تستخدم التنبيهات صيغة blockquote مع وسم خاص في السطر الأول. الصيغة دائما واحدة: > [!TYPE] ثم يكتب المحتوى في السطر التالي مسبوقا أيضا بـ >.

> [!NOTE]
> معلومات مفيدة يجب أن يعرفها المستخدمون،
> حتى عند التصفح السريع.

NOTE - يظهر كمربع معلومات أزرق. استخدمه للسياق الإضافي المفيد لكنه غير حرج.

> [!TIP]
> نصيحة عملية لعمل الأشياء بشكل أفضل
> أو أسهل.

TIP - يظهر كمربع اقتراح أخضر. مناسب للممارسات الجيدة والاختصارات.

> [!IMPORTANT]
> معلومات أساسية يجب على المستخدمين
> معرفتها لتحقيق الهدف.

IMPORTANT - يظهر كمربع بنفسجي للتأكيد. مناسب لما لا ينبغي تخطيه.

> [!WARNING]
> معلومات عاجلة تحتاج إلى الانتباه
> لتجنب المشاكل.

WARNING - يظهر كمربع تحذير أصفر. استخدمه للمخاطر أو الأخطاء المحتملة.

> [!CAUTION]
> ينبه إلى المخاطر أو النتائج السلبية
> لبعض الإجراءات.

CAUTION - يظهر كمربع خطر أحمر. احتفظ به للحالات غير القابلة للعكس.

## نصائح الاستخدام

كتابة تنبيهات فعالة

استخدمها باعتدال

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

طابق النوع مع مستوى الخطورة

لا تستخدم CAUTION لنصيحة بسيطة، ولا NOTE لمعلومة قد تحذف قاعدة بيانات. التدرج اللوني موجود ليعطي القارئ إشارة فورية عن الشدة.

اجعل المحتوى مختصرا

تعمل التنبيهات بأفضل شكل مع جملتين إلى ثلاث. إذا احتجت فقرات متعددة، فالمكان الأنسب هو النص الرئيسي.

يمكنك تضمين عناصر أخرى

تعمل الروابط و`inline code` وbold وitalic داخل التنبيهات. فقط ابدأ كل سطر بـ >.

## التوافق

أين تظهر التنبيهات

الأداة	الدعم
GitHub (الويب)	دعم كامل مع صناديق ملوّنة وأيقونات
ShowMeMyMD	دعم كامل للتنبيهات المنسقة على سطح المكتب
بعض إضافات VS Code	يختلف حسب الإضافة
معظم العارضات الأخرى	لا، تظهر كاقتباس عادي
محللات CommonMark القياسية	لا، مجرد blockquote عادي
محللات GFM الأقدم	لا، مجرد blockquote عادي

أغلب العارضات تعرض blockquote فقط.

يعرض ShowMeMyMD التنبيه الكامل الملوّن والأيقونة والتنسيق الصحيح، كما يظهر في GitHub. إذا كنت تكتب README أو توثيقا مع تنبيهات، فهذا من أفضل الطرق لمعاينتها محليا على Mac.

تنبيهات GitHub كما ينبغي أن تظهر

افتح Markdown محليا، وشاهد NOTE و TIP و WARNING و CAUTION بشكلها الصحيح.