Markdown: صيغة الاقتباسات والتداخل في Markdown

الاقتباسات تجعل مستنداتك أكثر إقناعًا — سواء كنت تستشهد برأي خبير أو تبرز ملاحظة مهمة، الاقتباسات هي أفضل أداة لل��همة.

1. ما ستتعلمه


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

(1) نقطة الألم: سوء استخدام الاقتباسات

كان جوردان يدير ورشة كتابة توثيق لفريق تقني واكتشف أن الجميع تقريبًا كانوا يقومون بـ "الاقتباس" بالطريقة الخاطئة — بعضهم كان يزيح النص يدويًا بخط رمادي، وبعضهم استخدم المائل، وبعضهم حتى لصق لقطات شاشة لنصوص الآخرين. كانت الاقتباسات تندمج مع النص الرئيسي، مما جعل من المستحيل على القراء التمييز بين كلمات المؤلف والمصادر الخارجية.

(2) الحل: توحيد تنسيق الاقتباس بـ >

وضع جوردان قاعدة للفريق: جميع النصوص الخارجية المقتبسة والنصائح المهمة والتحذيرات يجب أن تستخدم صيغة الاقتباس >. يفحص البرنامج النصي للتنسيق في الفريق تنسيق الاقتباس القياسي. بعد ثلاثة أشهر، قفز اتساق نقل الاقتباس من 30% إلى 98%.


3. أساسيات الاقتباس

(1) الصيغة الأساس��ة

استخدم > في بداية السطر لإنشاء اقتباس:

MARKDOWN
> هذا اقتباس.
> هذا هو السطر الثاني من الاقتباس.
💡 نصيحة: إضافة > إلى كل سطر هو النهج الأكثر أمانًا. بعض المحللات تدعم أيضًا > واحدة في بداية الفقرة:

MARKDOWN
> هذه فقرة اقتباس مع > فقط في السطر الأول.
هذا هو الاستمرار (مدعوم من بعض المحللات).
⚠️ ملاحظة: للحصول على أقصى توافق، أضف > إلى كل سطر.

(2) الأسطر الفارغة في الاقتباسات

الأسطر الفارغة داخل الاقتباسات تحتاج أيضًا إلى >:

MARKDOWN
> الفقرة الأولى.
>
> الفقرة الثانية (مع سطر فارغ و `>` بينهما).

▶ مثال: استخدام الاقتباس القياسي

MARKDOWN
في *المبرمج العملي*، يشير المؤلفان إلى:

> جوهر تطوير البرمجيات ليس كتابة التعليمات البرمجية، بل إدارة التعقيد.
> المبرمج الجيد ليس من يكتب أكبر قدر من التعليمات البرمجية، بل من يجعل التعليمات البرمجية أوضح.
⚠️ ملاحظة: لا تتجاوز 3 مستويات من التداخل — تنخفض قابلية القراءة بشكل حاد بعد ذلك.

▶ مثال: اقتباسات متداخلة حوارية

MARKDOWN
> **مدير المشروع:** هل يمكن إطلاق هذه الميزة يوم الجمعة؟
>
> > **المطور:** الوظيفة الأساسية جاهزة، لكن بعض الحالات الحدية لا تزال بحاجة للاختبار.
> >
> > > **مهندس ضمان الجودة:** نفذت 80% من حالات الاختبار. يجب أن تكون النتائج جاهزة بحلول الأربعاء.
💡 نصيحة: الاقتباسات المتداخلة رائعة لمحاكاة المحادثات وسلاسل التعليقات متعددة المستويات أو عرض اقتباس داخل اقتباس (مثلاً، في الأوراق الأكاديمية).


5. عناصر أخرى داخل الاقتباسات

(1) العناوين في الاقتباسات

MARKDOWN
> ## الحجة الأساسية للمادة المقتبسة
>
> هذا هو النص الرئيسي للمحتوى المقتبس.
>
> > ### الحجة الفرعية 1
> >
> > شرح مفصل للحجة الفرعية.

(2) القوائم في الاقتباسات

MARKDOWN
> متطلبات المشروع:
>
> - دعم 1,000 مستخدم متزامن
> - وقت استجابة < 200 مللي ثانية
> - توفر بنسبة 99.9%

(3) كتل التعليمات البرمجية في الاقتباسات

MARKDOWN
> **الخوارزمية الأساسية:**
>
> ```python
> def fibonacci(n):
>     if n <= 1:
>         return n
>     return fibonacci(n-1) + fibonacci(n-2)
> ```
>
> الخوارزمية أعلاه لها تعقيد زمني O(2^n) ويمكن تحسينها بالبرمجة الديناميكية.

▶ مثال: تضمين عناصر متعددة في اقتباس

MARKDOWN
> ## نتائج مراجعة التصميم التقني
>
> بعد تقييم الفريق، قررنا اعتماد **بنية الخدمات الصغرى**.
>
> | النهج | القابلية للتو��ع | تكلفة الصيانة |
> |:-----|:------:|:--------:|
> | أحادي | منخفضة | منخفضة |
> | خدمات صغرى | عالية | عالية |
>
> > ملاحظة: الخدمات الصغرى مناسبة للفرق التي تضم 10+ أفراد. الفرق الصغيرة يجب أن تبدأ بنموذج أحادي.
💡 نصيحة: يمكن أن تحتوي الاقتباسات على عناوين وقوائم وكتل تعليمات برمجية وجداول ومعظم عناصر Markdown الأخرى. هذا يحول الاقتباس من "مجرد نص رمادي" إلى كتلة محتوى قائمة بذاتها.


6. الاقتباسات مقابل مربعات التنبيه

صيغة > وأنماط > **💡 نصيحة:** المستخدمة في هذا الدرس كلاهما اقتباسات، لكنهما تخدمان أغراضًا مختلفة:

النوع الصيغة المظهر الغرض
اقتباس قياسي > نص شريط عمودي رمادي نقل المصادر الخارجية، الحوار
تنبيه نصيحة > **💡 نصيحة:** نص شريط رمادي + أيقونة نصائح أساسية، ملاحظات مهمة
تنبيه تحذير > **⚠️ ملاحظة:** نص شريط رمادي + أيقونة تحذيرات، أخطاء شائعة
MARKDOWN
> اقتباس قياسي: نقل وجهة نظر مؤلف خارجي.

> **💡 نصيحة:** هذا تنبيه نصيحة — يبرز معلومات أساسية للقارئ.

> **⚠️ ملاحظة:** هذا تنبيه تحذير — ينبه القراء للمخاطر ويساعدهم على تجنب الأخطاء.
💡 نصيحة: في التوثيق التقني، استخدم الاقتباسات القياسية لنقل المصادر الخارجية، والتنبيهات المعززة بالرموز التعبيرية للنصائح والتحذيرات. إبقاؤها متميزة بصريًا يساعد القراء على فهم القصد بسرعة.


7. استخدامات متقدمة للاقتباس في التخطيط

(1) استخدام الاقتباسات كـ "أشرطة جانبية"

MARKDOWN
## قرار رئيسي

اخترنا PostgreSQL كقاعدة بيانات أساسية.

> **مبرر القرار:**
> 1. الفريق لديه 3 سنوات من الخبرة مع PostgreSQL
> 2. المشروع يحتاج إلى استعلامات معقدة ودعم المعاملات
> 3. ميزانية محدودة — PostgreSQL مفتوحة المصدر ومجانية

(2) اقتباسات داخل اقتباسات (طبقة بطبقة)

MARKDOWN
تنص الورقة الأصلية على:

> تظهر النتائج التجريبية أن هذه الطريقة فعالة.
>
> > تؤكد الأبحاث اللاحقة ذلك:
> >
> > > بعد 10 تكرارات مستقلة، النتائج متسقة.
💡 نصيحة: الاقتباسات متعددة المستويات شائعة في الكتابة الأكاديمية، لكن في التوثيق التقني، التزم بمستويين أو أقل. كلما زاد عمق التداخل، كان من الأسهل على القراء أن يضيعوا.


8. مثال كامل: تنظيم مراجعة تقنية بالاقتباسات

MARKDOWN
# تقرير مراجعة البنية

## نتيجة المراجعة

بعد اجتماع مراجعة البنية في 15 يونيو 2026، اتخذ الفريق القرارات التالية:

## اختيار قاعدة البيانات

> **القرار النهائي:** اعتماد PostgreSQL.
>
> **المبرر:**
> - المشروع يتطلب استعلامات جغرافية مكانية معقدة (PostGIS)
> - الفريق لديه خبرة واسعة مع PostgreSQL
> - مقارنة بـ MongoDB، تقدم PostgreSQL دعمًا أقوى للمعاملات
>
> | المقارنة | PostgreSQL | MongoDB |
> |:-------|:----------:|:-------:|
> | المعاملات | ✅ ACID | ✅ متعدد المستندات |
> | الجغرافي المكاني | ✅ PostGIS | ✅ مدمج |
> | خبرة الفريق | 3 سنوات | سنة واحدة |

## خطة النشر

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

## تذكيرات

> **⚠️ ملاحظة:** أثناء الترحيل، حافظ على تشغيل النظام القديم في وقت واحد لمدة أسبوعين على الأقل لضمان سلامة البيانات.

النتيجة المتوقعة: مستند مراجعة بنية احترافي حيث تفصل الاقتباسات بوضوح آراء المشاركين المختلفين والقرارات النهائية.


❓ أسئلة شائعة

س ما الفرق بين الاقتباس والإزاحة؟
ج الاقتباسا�� لها علامة شريط عمودي رمادي وهي كتل قائمة بذاتها بصريًا. الإزاحة فقط تحرك الكتلة بأكملها أفقيًا. استخدم الاقتباسات للإشارة إلى "هذا المحتوى يأتي من مكان آخر"؛ استخدم الإزاحة لـ "هذا استمرار للنص الرئيسي."
س هل يمكنني وضع صور في اقتباس؟
ج نعم. > ![نص بديل](صورة.png) تُعرض كصورة داخل الاقتباس. لكن الصور الكبيرة في الاقتباسات يمكن أن تشعر بالضيق — استخدمها باعتدال.
س ماذا لو كان الاقتباس طويلًا جدًا ويضر بقابلية القراءة؟
ج قلص المحتوى المقتبس إلى الأسطر الأكثر أهمية. إذا كانت هناك حاجة لنقل مقطع طويل، فكر في تلخيصه بكلماتك الخاصة والربط بالأصل في الأسفل.
س ما الفرق بين التنبيهات والاقتباسات؟
ج التنبيهات هي أساسًا اقتباسات مع إضافة رموز تعبيرية ونص غامق للتأكيد البصري. كلاهما يُعرضان كعنصر HTML <blockquote> نفسه.

📖 ملخص


📝 تمارين

  1. أساسي: اكتب مراجعة قصيرة لكتاب باستخدام الاقتباسات مع فقرتين على الأقل مفصولتين بسطر > فارغ.

  2. متوسط: أنشئ اقتباسًا مزدوج التداخل يحاكي سيناريو "معلم يقتبس خبيرًا، ثم طالب يقتبس شرح المعلم". يجب أن يحتوي كل مستوى على 2-3 أسطر على الأقل.

  3. متقدم: اكتب "سجل قرار تقني" يجمع بين الاقتباسات القياسية (نقل مصادر خارجية)، وتنبيهات التحذير (⚠️ تنبيهات المخاطر)، والجداول (مقارنات النهج)، وكتل التعليمات البرمجية (أمثلة التعليمات البرمجية) — كل ذلك داخل اقتباس لاختبار العرض.

Web-Tutorial.com

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

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

100%