Markdown: تنسيق النص في Markdown: عريض ومائل وما بعده

تنسيق النص هو توابل الكتابة — استخدمه بشكل صحيح، وسيكتشف القراء النقاط الرئيسية فورًا.

1. ما ستتعلمه


2. قصة حقيقية لكاتب تقني

(1) نقطة الألم: عدم اتساق التنسيق سبب فوضى

كان ديفيد مسؤولاً عن صيانة الويكي التقني الداخلي للفريق ووجد أن الصفحات التي كتبها أشخاص مختلفون كانت منسقة بشكل غير متسق — بعضهم استخدم ** للعريض، وآخرون استخدموا __؛ بعضهم استخدم * للمائل، وآخرون استخدموا _. الأسوأ من ذلك، أن بعض الأشخاص خلطوا الكلمات المفتاحية التي يجب أن تكون عريضة مع النص العادي، مما جعل القراءة صعبة.

(2) الحل: إرشادات نمط موحدة

أنشأ ديفيد إرشادات نمط Markdown للفريق: الكلمات المفتاحية بـ **عريض**، وعناوين الكتب والمصطلحات التقنية بـ *مائل*، والمحتوى الملغى بـ ~~يتوسطه خط~~. بعد تطبيق الإرشا��ات، قفزت درجة قابلية القراءة للويكي من 6.2 إلى 9.0. لم يعد أعضاء الفريق الجدد بحاجة إلى تخمين كيفية تنسيق أي شيء.


3. أساسيات تنسيق النص

صيغة تنسيق النص في Markdown بديهية — تغلف النص بـ رموز مزدوجة:

100%
graph LR
    A[أنماط النص] --> B[عريض ** **]
    A --> C[مائل * *]
    A --> D[يتوسطه خط ~~ ~~]
    A --> E[فاصل أفقي ---]
    B --> F[تأكيد الكلمات المفتاحية]
    C --> G[المصطلحات / عناوين الكتب]
    D --> H[المحتوى الملغى / المحذوف]
    E --> I[فصل المحتوى]
النمط الصيغة الاختصار (VS Code) العرض
عريض **نص** أو __نص__ Ctrl+B عريض
مائل *نص* أو _نص_ Ctrl+I مائل
عريض + مائل ***نص*** Ctrl+B + Ctrl+I عريض مائل
يتوسطه خط ~~نص~~ Alt+Shift+S يتوسطه خط
فاصل أفقي --- أو *** أو ___ لا يوجد اختصار خط أفقي

(1) العريض

غلف النص بنجمتين مزدوجتين ** أو شرطتين سفليتين مزدوجتين __:

MARKDOWN
هذا مفهوم **مهم**.

**ملاحظة:** هذا القسم يتطلب انتباهًا.

يُنصح باستخدام النجمات `**` لأنها تبرز أكثر من الشرطات السفلية `__` في النص العادي.
💡 نصيحة: استخدم ** طوال الوقت بدلاً من __، لأن _ قد تُفسر خطأً كمائل داخل الكلمات (مثل الشرطات السفلية في some_func(param1, param2)).

(2) المائل

غلف النص بنجمة واحدة * أو شرطة سفلية واح��ة _:

MARKDOWN
هذا كتاب كلاسيكي عن *أنماط التصميم*.

في الإنجليزية، تُعرض عناوين الكتب عادة بـ *مائل*.

ملاحظة: _هذا النص_ سيُعرض أيضًا بمائل.
⚠️ ملاحظة: المائل لا يبرز بنفس القدر في النصوص غير اللاتينية، لكنه مفيد جدًا للنصوص الإنجليزية ومقتطفات التعليمات البرمجية.

▶ مثال: دمج العريض والمائل

MARKDOWN
**مهم:** تم إلغاء هذه الميزة في *الإصدار 2.0*. يرجى استخدام ***API الجديد*** بدلاً من ذلك.

4. النص المتوسط والفاصل الأفقي

(1) النص المتوسط

يستخدم النص المتوسط تيلدتين مزدوجتين ~~ للإشارة إلى أن النص قد تمت إزالته أو إلغاؤه:

MARKDOWN
السعر الأصلي: ~~299$~~ **199$** (عرض لفترة محدودة)

تم إلغاء الميزة التالية: ~~API القديم~~ — يرجى استخدام الإصدار الجديد.

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

(2) الفاصل الأفقي

يتم إنشاء الفاصل الأفقي بثلاثة رموز أو أكثر من - أو * أو _:

MARKDOWN
# الجزء الأول

هذا هو محتوى الجزء الأول.

---

# الجزء الثاني

هذا هو محتوى الجزء الثاني.

---

---

رموز الفواصل الأفقية المتعددة جميعها تنتج نفس النتيجة.
⚠️ ملاحظة: اترك سطرًا فارغًا فوق وتحت الفاصل الأفقي، وإلا قد يُفسر خطأً كعنوان Setext (إذا كان السطر ��علاه يحتوي على نص).

▶ مثال: استخدام الفواصل الأفقية في سياقات مختلفة

MARKDOWN
# توثيق المشروع

## دليل التثبيت
...

---

## تعليمات الاستخدام
...

---

## مرجع API
...
💡 نصيحة: الفواصل الأفقية رائعة لفصل الأقسام الرئيسية، لكن تجنب استخدامها داخل كتلة نصية واحدة. ثلاثة إلى خمسة فواصل لكل مقالة كافية.


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

تختلف قواعد فواصل الأسطر في Markdown عن Word — انتبه:

الإجراء الصيغة العرض
فقرة جديدة سطر فارغ بين الأسطر فقرة جديدة (تباعد أكبر)
فاصل سطر (فاصل ناعم) مسافتان في نهاية السطر، ثم Enter سطر جديد (تباعد أصغر)
بدون فاصل نص متصل يدمج تلقائيًا في نفس الفقرة
MARKDOWN
هذا هو السطر الأول،  
هذا هو السطر الثاني (مسافتان في النهاية).

هذه فقرة جديدة (سطر فارغ أعلاه).

هذا نص ضمن نفس الفقرة —
لاحظ أن فاصل السطر هذا لن يعمل (لا توجد مسافات في النهاية).
💡 نصيحة: معظم محررات Markdown (مثل Typora) لا تتطلب مسافات في النهاية — الضغط على Enter يُدخل فاصل سطر مباشرة. لكن على GitHub وفي محللات CommonMark الصارمة، المسافتان في النهاية هما النهج القياسي.

▶ مثال: مقارنة تأثيرات فاصل السطر

MARKDOWN
بدون مسافات في النهاية
فاصل السطر لم يُطبق (نفس الفقرة)

مسافتان في النهاية··
تم تطبيق فاصل السطر.

سطر فارغ =
فقرة جديدة.

6. تخطي الأحرف الخاصة

عندما تريد عرض رموز Markdown كأحرف حرفية (بدلاً من أن تصبح سارية المفعول)، قم بتخطيها بشرطة مائلة عكسية \:

النص الخام بعد التخطي العرض
**ليس عريضًا** \*\*ليس عريضًا\*\* ليس عريضًا (تظهر النجمات حرفيًا)
# ليس عنوانًا \# ليس عنوانًا # ليس عنوانًا
--- ليس فاصلاً \-\-\- ليس فاصلاً --- ليس فاصلاً
MARKDOWN
سيناريوهات التخطي الشائعة:
- عرض نجمة: \*هذا ليس مائلاً\*
- عرض علامة المربع: \# هذا ليس عنوانًا
- عرض الفاصلة العليا: \` \` (استخدم فاصلتين عليا مزدوجتين)
- عرض الشرطة المائلة العكسية نفسها: \\\\
💡 نصيحة: إليك القاعدة الأساسية — قم فقط بتخطي الرموز التي لها معنى خاص في Markdown. علامات الترقيم العادية (الفواصل، النقاط، الأقواس) لا تحتاج إلى تخطي.


7. مثال كامل: تنسيق إعلان منتج

TEXT 📖 للعرض فقط
# تحديث الإصدار: v3.0 تم إصداره رسميًا

يسعدنا أن نعلن أن Product Pro v3.0 متاح اليوم!

الميزات الجديدة:
1. الوضع الداكن — ألطف على العينين، عمر بطارية أطول
2. توصيات ذكية — مصممة حسب عادات استخدامك
3. لوحة التحكم القديمة → لوحة تحكم تفاعلية جديدة بالكامل

أمر التثبيت:
npm install product-pro@latest

ملاحظة: مستخدمو v2.x، يرجى الرجوع إلى دليل الترحيل إلى v3

النتيجة المتوقعة: إعلان منتج منسق بشكل غني مع نص عريض يبرز المعلومات الرئيسية، ونص متوسط للميزات الملغاة، وفواصل أفقية تفصل بين الأقسام.


❓ أسئلة شائعة

س أيهما أفضل للتأكيد، العريض أم المائل؟
ج العريض لتأكيد الكلمات المفتاحية والمعلومات الهامة؛ المائل لعناوين الكتب والمصطلحات التقنية والتمييزات الدقيقة. لا تجعل كل شيء عريضًا — فهذا نفس عدم تأكيد أي شيء.
س لماذا لا يعمل الفاصل الأفقي لدي؟
ج الأسباب الشائعة: ① السطر أعلاه غير مفصول بسطر فارغ (تفسره المحللة كعنوان Setext)؛ استخدمت مسافات بدلاً من الشرطات؛ --- داخل كتلة تعليمات برمجية.
س ماذا لو لم يعمل فاصل السطر لدي؟
ج أضف مسافتين في نهاية السطر، ثم اضغط Enter. أو ببساطة أدخل سطرًا فارغًا لبدء فقرة جديدة. في محررات مثل Typora، Shift+Enter يُدخل فاصل سطر ناعم.
س هل يجب أن أضيف مسافات بين الأحرف المختلفة؟
ج نعم، يُنصح بذلك. هذا درس Markdown أسهل قراءة من هذا درسماركداون. إنه ليس متطلبًا في صيغة Markdown — إنه اصطلاح طباعي.
س هل يمكنني استخدام كل من النجمات والشرطات السفلية؟
ج نعم، لكن لا يُنصح بخلطهما. في مستند واحد، التزم بالنجمتين المزدوجتين للعريض والنجمة الواحدة للمائل للحفاظ على اتساق أسلوبك.

📖 ملخص


📝 تمارين

  1. مبتدئ: اكتب مقدمة ذاتية قصيرة بـ Markdown تتضمن عريض (اسمك/مهاراتك)، ومائل (شعارك)، ونص متوسط (معلومة قديمة)، وفاصل أفقي.

  2. متوسط: اكتب بضعة أسطر من النص للتحقق من الفرق بين فاصل السطر بمسافتين في النهاية وبدون مسافات. ثم قم بتخطي رمز ** بـ \ ليظهر كنجمات حرفية بدلاً من عريض.

  3. متقدم: اكتب سجل تغييرات منتج يتضمن ميزتين جديدتين على الأقل (عريض)، وميزة واحدة ملغاة (نص متوسط)، وملاحظة هامة واحدة (عريض + مائل)، و3 فواصل أفقية. تأكد من أن التنسيق نظيف والتسلسل الهرمي واضح.

Web-Tutorial.com

فريق Web-Tutorial التقني

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

100%