Markdown: صيغة الاقتباسات والتداخل في Markdown
الاقتباسات تجعل مستنداتك أكثر إقناعًا — سواء كنت تستشهد برأي خبير أو تبرز ملاحظة مهمة، الاقتباسات هي أفضل أداة لل��همة.
1. ما ستتعلمه
- صيغة الاقتباس الأساسية والاستخدام
- الاقتباسات متعددة الفقرات والمتداخلة
- تضمين القوائم والتعليمات البرمجية والعناوين داخل الاقتباسات
- أفضل ممارسات الاقتباس في تخطيط المستند
- الاقتباسات مقابل مربعات التنبيه
2. قصة حقيقية لمدرب كتابة تقنية
(1) نقطة الألم: سوء استخدام الاقتباسات
كان جوردان يدير ورشة كتابة توثيق لفريق تقني واكتشف أن الجميع تقريبًا كانوا يقومون بـ "الاقتباس" بالطريقة الخاطئة — بعضهم كان يزيح النص يدويًا بخط رمادي، وبعضهم استخدم المائل، وبعضهم حتى لصق لقطات شاشة لنصوص الآخرين. كانت الاقتباسات تندمج مع النص الرئيسي، مما جعل من المستحيل على القراء التمييز بين كلمات المؤلف والمصادر الخارجية.
(2) الحل: توحيد تنسيق الاقتباس بـ >
وضع جوردان قاعدة للفريق: جميع النصوص الخارجية المقتبسة والنصائح المهمة والتحذيرات يجب أن تستخدم صيغة الاقتباس >. يفحص البرنامج النصي للتنسيق في الفريق تنسيق الاقتباس القياسي. بعد ثلاثة أشهر، قفز اتساق نقل الاقتباس من 30% إلى 98%.
3. أساسيات الاقتباس
(1) الصيغة الأساس��ة
استخدم > في بداية السطر لإنشاء اقتباس:
> هذا اقتباس.
> هذا هو السطر الثاني من الاقتباس.
> إلى كل سطر هو النهج الأكثر أمانًا. بعض المحللات تدعم أيضًا > واحدة في بداية الفقرة:
> هذه فقرة اقتباس مع > فقط في السطر الأول.
هذا هو الاستمرار (مدعوم من بعض المحللات).
> إلى كل سطر.
(2) الأسطر الفارغة في الاقتباسات
الأسطر الفارغة داخل الاقتباسات تحتاج أيضًا إلى >:
> الفقرة الأولى.
>
> الفقرة الثانية (مع سطر فارغ و `>` بينهما).
▶ مثال: استخدام الاقتباس القياسي
في *المبرمج العملي*، يشير المؤلفان إلى:
> جوهر تطوير البرمجيات ليس كتابة التعليمات البرمجية، بل إدارة التعقيد.
> المبرمج الجيد ليس من يكتب أكبر قدر من التعليمات البرمجية، بل من يجعل التعليمات البرمجية أوضح.
▶ مثال: اقتباسات متداخلة حوارية
> **مدير المشروع:** هل يمكن إطلاق هذه الميزة يوم الجمعة؟
>
> > **المطور:** الوظيفة الأساسية جاهزة، لكن بعض الحالات الحدية لا تزال بحاجة للاختبار.
> >
> > > **مهندس ضمان الجودة:** نفذت 80% من حالات الاختبار. يجب أن تكون النتائج جاهزة بحلول الأربعاء.
5. عناصر أخرى داخل الاقتباسات
(1) العناوين في الاقتباسات
> ## الحجة الأساسية للمادة المقتبسة
>
> هذا هو النص الرئيسي للمحتوى المقتبس.
>
> > ### الحجة الفرعية 1
> >
> > شرح مفصل للحجة الفرعية.
(2) القوائم في الاقتباسات
> متطلبات المشروع:
>
> - دعم 1,000 مستخدم متزامن
> - وقت استجابة < 200 مللي ثانية
> - توفر بنسبة 99.9%
(3) كتل التعليمات البرمجية في الاقتباسات
> **الخوارزمية الأساسية:**
>
> ```python
> def fibonacci(n):
> if n <= 1:
> return n
> return fibonacci(n-1) + fibonacci(n-2)
> ```
>
> الخوارزمية أعلاه لها تعقيد زمني O(2^n) ويمكن تحسينها بالبرمجة الديناميكية.
▶ مثال: تضمين عناصر متعددة في اقتباس
> ## نتائج مراجعة التصميم التقني
>
> بعد تقييم الفريق، قررنا اعتماد **بنية الخدمات الصغرى**.
>
> | النهج | القابلية للتو��ع | تكلفة الصيانة |
> |:-----|:------:|:--------:|
> | أحادي | منخفضة | منخفضة |
> | خدمات صغرى | عالية | عالية |
>
> > ملاحظة: الخدمات الصغرى مناسبة للفرق التي تضم 10+ أفراد. الفرق الصغيرة يجب أن تبدأ بنموذج أحادي.
6. الاقتباسات مقابل مربعات التنبيه
صيغة > وأنماط > **💡 نصيحة:** المستخدمة في هذا الدرس كلاهما اقتباسات، لكنهما تخدمان أغراضًا مختلفة:
| النوع | الصيغة | المظهر | الغرض |
|---|---|---|---|
| اقتباس قياسي | > نص |
شريط عمودي رمادي | نقل المصادر الخارجية، الحوار |
| تنبيه نصيحة | > **💡 نصيحة:** نص |
شريط رمادي + أيقونة | نصائح أساسية، ملاحظات مهمة |
| تنبيه تحذير | > **⚠️ ملاحظة:** نص |
شريط رمادي + أيقونة | تحذيرات، أخطاء شائعة |
> اقتباس قياسي: نقل وجهة نظر مؤلف خارجي.
> **💡 نصيحة:** هذا تنبيه نصيحة — يبرز معلومات أساسية للقارئ.
> **⚠️ ملاحظة:** هذا تنبيه تحذير — ينبه القراء للمخاطر ويساعدهم على تجنب الأخطاء.
7. استخدامات متقدمة للاقتباس في التخطيط
(1) استخدام الاقتباسات كـ "أشرطة جانبية"
## قرار رئيسي
اخترنا PostgreSQL كقاعدة بيانات أساسية.
> **مبرر القرار:**
> 1. الفريق لديه 3 سنوات من الخبرة مع PostgreSQL
> 2. المشروع يحتاج إلى استعلامات معقدة ودعم المعاملات
> 3. ميزانية محدودة — PostgreSQL مفتوحة المصدر ومجانية
(2) اقتباسات داخل اقتباسات (طبقة بطبقة)
تنص الورقة الأصلية على:
> تظهر النتائج التجريبية أن هذه الطريقة فعالة.
>
> > تؤكد الأبحاث اللاحقة ذلك:
> >
> > > بعد 10 تكرارات مستقلة، النتائج متسقة.
8. مثال كامل: تنظيم مراجعة تقنية بالاقتباسات
# تقرير مراجعة البنية
## نتيجة المراجعة
بعد اجتماع مراجعة البنية في 15 يونيو 2026، اتخذ الفريق القرارات التالية:
## اختيار قاعدة البيانات
> **القرار النهائي:** اعتماد PostgreSQL.
>
> **المبرر:**
> - المشروع يتطلب استعلامات جغرافية مكانية معقدة (PostGIS)
> - الفريق لديه خبرة واسعة مع PostgreSQL
> - مقارنة بـ MongoDB، تقدم PostgreSQL دعمًا أقوى للمعاملات
>
> | المقارنة | PostgreSQL | MongoDB |
> |:-------|:----------:|:-------:|
> | المعاملات | ✅ ACID | ✅ متعدد المستندات |
> | الجغرافي المكاني | ✅ PostGIS | ✅ مدمج |
> | خبرة الفريق | 3 سنوات | سنة واحدة |
## خطة النشر
> **رأي المدير التنفيذي:**
>
> > أقترح البدء بنموذج أحادي وتقسيمه بمجرد نمو أعداد المستخدمين.
>
> **رد الفريق الهندسي:**
>
> نحن نتفق مع هذه الاستراتيجية. ومع ذلك، ستكون طبقة اتصال قاعدة البيانات وحدة مستقلة لتسهيل الترحيل المستقبلي إلى الخدمات الصغرى.
## تذكيرات
> **⚠️ ملاحظة:** أثناء الترحيل، حافظ على تشغيل النظام القديم في وقت واحد لمدة أسبوعين على الأقل لضمان سلامة البيانات.
النتيجة المتوقعة: مستند مراجعة بنية احترافي حيث تفصل الاقتباسات بوضوح آراء المشاركين المختلفين والقرارات النهائية.
❓ أسئلة شائعة
>  تُعرض كصورة داخل الاقتباس. لكن الصور الكبيرة في الاقتباسات يمكن أن تشعر بالضيق — استخدمها باعتدال.<blockquote> نفسه.📖 ملخص
- الاقتباسات تستخدم
>، أضفها إلى كل سطر لأقصى توافق - التداخل متعدد المستويات يستخدم
>>،>>>— لا تتجاوز 3 مستويات - يمكن أن تحتوي الاقتباسات على عناوين وقوائم وكتل تعليمات برمجية وجداول
- الاقتباسات مثالية لنقل المصادر الخارجية وإبراز المعلومات الأساسية
- التنبيهات هي اقتباسات معززة برموز تعبيرية وتنسيق غامق للتمييز البصري
- حافظ على الاقتباسات موجزة — الاقتباسات الطويلة تعطل تدفق المستند
📝 تمارين
-
أساسي: اكتب مراجعة قصيرة لكتاب باستخدام الاقتباسات مع فقرتين على الأقل مفصولتين بسطر
>فارغ. -
متوسط: أنشئ اقتباسًا مزدوج التداخل يحاكي سيناريو "معلم يقتبس خبيرًا، ثم طالب يقتبس شرح المعلم". يجب أن يحتوي كل مستوى على 2-3 أسطر على الأقل.
-
متقدم: اكتب "سجل قرار تقني" يجمع بين الاقتباسات القياسية (نقل مصادر خارجية)، وتنبيهات التحذير (⚠️ تنبيهات المخاطر)، والجداول (مقارنات النهج)، وكتل التعليمات البرمجية (أمثلة التعليمات البرمجية) — كل ذلك داخل اقتباس لاختبار العرض.