قواعد التأكيد

تُستخدم صيغة التأكيد لإبراز النص، وهي إحدى وظائف التنسيق الأكثر استخداماً في Markdown. من خلال طرق التأكيد المختلفة، يمكن جعل المحتوى المهم أكثر وضوحاً.

صيغة التأكيد الأساسية

مائل (Italic)

استخدم علامة النجمة * واحدة أو شرطة سفلية _ لإحاطة النص:

*نص مائل*
_نص مائل_

نتيجة العرض: نص مائلنص مائل

عريض (Bold)

استخدم علامتي النجمة ** أو شرطتين سفليتين __ لإحاطة النص:

**نص عريض**
__نص عريض__

نتيجة العرض: نص عريضنص عريض

عريض ومائل (Bold and Italic)

استخدم ثلاث علامات نجمة *** أو ثلاث شرطات سفلية ___، أو استخدم مزيجاً:

***نص عريض ومائل***
___نص عريض ومائل___
**_نص عريض ومائل_**
*__نص عريض ومائل__*

نتيجة العرض: نص عريض ومائلنص عريض ومائلنص عريض ومائلنص عريض ومائل

نصائح اختيار الصيغة

علامة النجمة مقابل الشرطة السفلية

الرمز	المزايا	العيوب	سيناريوهات مُوصى بها
*	أكثر شيوعاً، توافق أفضل	قد يختلط مع القوائم في بعض المحررات	مُوصى به بشكل عام
_	أوضح داخل الكلمات	أقل استخداماً، قد يكون غير مألوف	حالات خاصة

الاستخدام المُوصى به

✅ مُوصى به: الحفاظ على الاتساق
هنا يوجد نص **عريض** و *مائل*.

❌ غير مُوصى به: الاستخدام المختلط
هنا يوجد نص **عريض** و _مائل_.

استخدام التأكيد داخل الكلمات

قيود علامة النجمة

قد لا يتم التعرف على علامة النجمة داخل الكلمات:

love*is*beautiful  ← قد لا يُعرض كنص مائل

مزايا الشرطة السفلية

الشرطة السفلية أكثر موثوقية داخل الكلمات:

love_is_beautiful  ← أسهل في العرض بشكل صحيح

اقتراح: إذا كنت بحاجة لاستخدام التأكيد داخل الكلمات، فكر أولاً في الشرطة السفلية.

التأكيد المتداخل

التداخل الأساسي

يمكن تداخل النص المائل داخل النص العريض، أو تداخل النص العريض داخل النص المائل:

**هذا نص عريض يحتوي على نص *مائل***
*هذا نص مائل يحتوي على نص **عريض***

نتيجة العرض: هذا نص عريض يحتوي على نص مائلهذا نص مائل يحتوي على نص عريض

تداخل معقد

***هذا نص عريض ومائل يحتوي على نص عادي***
**فقرة عريضة تحتوي على *عبارة مائلة* ونص عادي***
*فقرة مائلة تحتوي على **كلمات مفتاحية عريضة** ونص عادي*

نتيجة العرض: هذا نص عريض ومائل يحتوي على نص عاديفقرة عريضة تحتوي على عبارة مائلة ونص عادي* فقرة مائلة تحتوي على كلمات مفتاحية عريضة ونص عادي

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

1. عدم تطابق الرموز

❌ خطأ:
*هذا نص مائل غير مغلق
**هذا نص عريض غير متطابق*

✅ صحيح:
*هذا نص مائل صحيح*
**هذا نص عريض صحيح**

2. مشكلة المسافات

❌ خطأ:
* هذا ليس نصاً مائلاً *
** هذا ليس نصاً عريضاً **

✅ صحيح:
*هذا نص مائل*
**هذا نص عريض**

3. الأحرف حول الرموز

❌ قد تكون هناك مشكلة:
نص*مائل*نص  ← قد لا يُعرض

✅ أكثر أماناً:
نص *مائل* نص
نص_مائل_نص

التعامل مع الحالات الخاصة

تهريب رموز التأكيد

إذا كنت بحاجة لعرض علامة النجمة أو الشرطة السفلية نفسها، استخدم الشرطة المائلة للتهريب:

\*هذا ليس نصاً مائلاً\*
\**هذا ليس نصاً عريضاً\**
\_هذا ليس نصاً مائلاً\_

نتيجة العرض: *هذا ليس نصاً مائلاً* *هذا ليس نصاً عريضاً* _هذا ليس نصاً مائلاً_

الاستخدام في الكود

في الكود السطري، سيتم عرض رموز التأكيد حرفياً:

`*علامات النجمة هنا لن تُفسر كنص مائل*`
`**علامات النجمة المزدوجة هنا لن تُفسر كنص عريض**`

نتيجة العرض: *علامات النجمة هنا لن تُفسر كنص مائل***علامات النجمة المزدوجة هنا لن تُفسر كنص عريض**

الاستخدام الدلالي

الاستخدامات الدلالية للنص المائل

• التأكيد: هذا مهم
• لغة أجنبية: Hello World
• مصطلحات: بروتوكول HTTP
• اقتباسات: كما ورد في "الملحمة الثلاثية"
• متغيرات: ضبط قيمة x على 10

الاستخدامات الدلالية للنص العريض

• الأهمية: انتبه للأمان
• كلمات مفتاحية: واجهة API
• تحذيرات: لا تحذف الملفات المهمة
• عناوين فرعية: الخطوة الأولى: تثبيت البرنامج

استخدامات النص العريض والمائل

• مهم جداً: لا تفعل هذا أبداً
• توصية قوية: يُوصى بشدة بقراءة الوثائق

أفضل الممارسات

1. الاستخدام المعتدل

✅ مُوصى به: تأكيد معتدل
هذه الوظيفة**مهمة**، يرجى قراءة الوثائق ذات الصلة بعناية.

❌ غير مُوصى به: تأكيد مفرط
**هذه الوظيفة*****مهمة***، **يرجى قراءة** الوثائق** ذات الصلة** بعناية.

2. الحفاظ على الاتساق

✅ مُوصى به: استخدام علامات النجمة بشكل موحد
استخدم **نص عريض** و *نص مائل* لتأكيد المحتوى.

❌ غير مُوصى به: رموز مختلطة
استخدم **نص عريض** و _نص مائل_ لتأكيد المحتوى.

3. الاستخدام الدلالي

✅ مُوصى به: تأكيد ذو معنى
ترجع الدالة **true** للدلالة على النجاح، وترجع **false** للدلالة على الفشل.

❌ غير مُوصى به: تأكيد زخرفي
الدالة**ترجع** true **للإشارة** إلى النجاح، **ترجع** false **للإشارة** إلى الفشل.

إخراج HTML

تحويل صيغة التأكيد في Markdown إلى HTML:

*مائل*     → <em>مائل</em>
**عريض**   → <strong>عريض</strong>
***عريض ومائل*** → <strong><em>عريض ومائل</em></strong>

الصيغة الموسعة

تدعم بعض معالجات Markdown طرق تأكيد إضافية:

خط الشطب

~~نص مشطوب~~

نتيجة العرض: نص مشطوب

الشرطة السفلية

<u>نص بشرطة سفلية</u>

نتيجة العرض: نص بشرطة سفلية

التمييز

==نص مميز==  (تدعمه بعض المعالجات)
<mark>نص مميز</mark>  (وسم HTML)

أمثلة عملية

الوثائق التقنية

**نقطة نهاية API**: `/api/users`

**الطريقة**: *GET*

**المعاملات**:
- *id* (***مطلوب***): معرف المستخدم
- *format* (اختياري): تنسيق الإرجاع

**الإرجاع**: معلومات المستخدم أو **رسالة خطأ**

دليل المستخدم

## خطوات التثبيت

**الخطوة الأولى**: تنزيل حزمة التثبيت

قم بزيارة صفحة التنزيل على الموقع الرسمي، واختر النسخة المناسبة لنظام التشغيل لديك. *تأكد من تنزيل أحدث إصدار*.

**الخطوة الثانية**: تشغيل برنامج التثبيت

انقر نقراً مزدوجاً على الملف المُنزّل، واتبع المعالج لإتمام التثبيت. ***مهم***: أغلق برنامج مكافحة الفيروسات أثناء التثبيت.

**الخطوة الثالثة**: التحقق من التثبيت

افتح سطر الأوامر، وأدخل `app --version` للتحقق من نجاح التثبيت.

قواعد ذات صلة

• قواعد الروابط - إنشاء روابط
• قواعد الشيفرة - تنسيق الشيفرة
• قواعد الاقتباس - نصوص مقتبسة
• الشطب - طريقة تأكيد موسعة

التمارين

حاول إنشاء مستند يحتوي على المحتوى التالي:

1. مقدمة منتج تستخدم النص العريض لإبراز الميزات الرئيسية
2. شرح تقني يستخدم النص المائل لتمييز المصطلحات
3. رسالة تحذيرية تستخدم النص العريض والمائل لتأكيد الأهمية
4. جملة مركبة تستخدم مزيجاً من طرق التأكيد المختلفة