الفقرات وكسر السطر
الفقرات وكسر السطر هما أساس وثائق Markdown. إتقان قواعدهما يجعل البنية واضحة وسهلة القراءة.
قواعد الفقرات
الفقرة هي أسطر نص متتابعة. لإنشاء فقرة افصل بسطر فارغ.
فقرة أساسية
هذه هي الفقرة الأولى. تحتوي هذه الفقرة على عدة جمل.
كل هذه الجمل تنتمي إلى نفس الفقرة.
هذه هي الفقرة الثانية. بينها وبين الأولى
سطر فارغ للفصل.
هذه هي الفقرة الثالثة.نتيجة العرض
هذه هي الفقرة الأولى. تحتوي هذه الفقرة على عدة جمل. كل هذه الجمل تنتمي إلى نفس الفقرة.
هذه هي الفقرة الثانية. بينها وبين الأولى سطر فارغ للفصل.
هذه هي الفقرة الثالثة.
قواعد كسر السطر
يوفر Markdown طريقتين لكسر السطر:
1) كسر صلب (إجباري)
أضف مسافتين أو أكثر في نهاية السطر ثم اضغط Enter:
هذا هو السطر الأول.
هذا هو السطر الثاني.نتيجة العرض
هذا هو السطر الأول.
هذا هو السطر الثاني.
2) كسر لين (فقرة جديدة)
استخدم سطراً فارغاً لإنشاء فقرة جديدة:
هذه هي الفقرة الأولى.
هذه هي الفقرة الثانية.نتيجة العرض
هذه هي الفقرة الأولى.
هذه هي الفقرة الثانية.
مقارنة طرق كسر السطر
| الطريقة | الصياغة | ناتج HTML | الاستخدام |
|---|---|---|---|
| فصل الفقرات | سطر فارغ | <p>...</p> | تقسيم منطقي |
| كسر صلب | مسافتان بنهاية السطر | <br> | شعر/عناوين |
| كسر بـ HTML | <br> | <br> | تحكم أدق |
أمثلة مقارنة
فصل الفقرات:
محتوى الفقرة الأولى.
محتوى الفقرة الثانية.كسر صلب:
محتوى السطر الأول.
محتوى السطر الثاني.كسر بـ HTML:
محتوى السطر الأول.<br>
محتوى السطر الثاني.مشكلات شائعة وحلولها
1) اتصال غير مقصود
المشكلة: اتصال سطرين بالخطأ
هذا هو السطر الأول
هذا هو السطر الثاني ← سيتم دمج السطرين في فقرة واحدةالحل: استخدم سطراً فارغاً أو مسافتين بنهاية السطر
هذا هو السطر الأول
هذا هو السطر الثاني ← الآن فقرتان منفصلتان
أو
هذا هو السطر الأول
هذا هو السطر الثاني ← الآن كسر صلب2) كسر سطر غير مقصود
المشكلة: ظهور كسر سطر غير مرغوب
هذه جملة طويلة
انقسمت بالخطأ على سطرينالحل: أبقِ النص في سطر واحد أو استخدم الصياغة الصحيحة للكسر
هذه جملة طويلة ويجب أن تبقى في فقرة واحدة.
أو استخدم كسراً صلباً بوضوح:
هذه جملة طويلة
وهنا كسر سطر مقصود.3) مشكلة المسافات غير المرئية
المشكلة: مسافات نهاية السطر غير مرئية ويسهل نسيانها
الحل:
- فعّل إظهار المحارف البيضاء في المحرر
- استخدم محرراً يدعم Markdown
- استخدم
<br>عند الحاجة
حالات خاصة
الشعر والكلمات
استخدم كسراً صلباً للحفاظ على كل سطر مستقلاً:
قصيدة قصيرة
يضيء ضوء القمر أمام سريري،
أحسبه صقيعاً على الأرض.
أرفع رأسي لأنظر إلى القمر،
وأخفضه متذكراً موطني.نتيجة العرض
قصيدة قصيرة
يضيء ضوء القمر أمام سريري،
أحسبه صقيعاً على الأرض.
أرفع رأسي لأنظر إلى القمر،
وأخفضه متذكراً موطني.
العناوين ومعلومات الاتصال
معلومات الاتصال:
حي الهايديان، بكين
شارع تشونغقوانتسون رقم 1
الرمز البريدي: 100000
أو استخدم HTML:
معلومات الاتصال:<br>
حي الهايديان، بكين<br>
شارع تشونغقوانتسون رقم 1<br>
الرمز البريدي: 100000تعليقات الشيفرة
/* هذا تعليق متعدد الأسطر
لكل سطر مسافة بادئة محددة
يجب الحفاظ على التنسيق */أفضل الممارسات
1) حافظ على الاتساق
وحّد أسلوب الفقرات وكسر السطر عبر المستند:
✅ مُوصى به: استخدم سطراً فارغاً لتقسيم الفقرات
محتوى الفقرة الأولى.
محتوى الفقرة الثانية.
محتوى الفقرة الثالثة.
❌ غير مُوصى: خلط طرق مختلفة
محتوى الفقرة الأولى.
محتوى الفقرة الثانية.
محتوى الفقرة الثالثة.2) تجنّب الإفراط في الكسر الصلب
✅ مُوصى به: دع الجمل الطويلة تتدفق طبيعياً
هذه جملة طويلة تحتوي على الكثير من المعلومات ويُفضّل أن تتدفق طبيعياً ضمن الفقرة.
❌ غير مُوصى: كسور صلبة غير ضرورية
هذه جملة طويلة،
تحتوي على الكثير من المعلومات،
ولا تحتاج إلى تقسيم الأسطر بهذا الشكل.3) قسّم النص دلالياً
✅ مُوصى به: قسّم النص منطقياً
## وصف المشكلة
أبلغ المستخدمون عن بطء في تسجيل الدخول. بعد التحقيق الأولي، تبيّن أن إعدادات تجمع الاتصالات قد تكون غير مناسبة.
## الحل
اضبط معاملات تجمع الاتصالات، وزِد الحد الأقصى للاتصالات، وحسّن إعدادات مهلة الاتصال.
❌ غير مُوصى: تقسيم عشوائي
## وصف المشكلة
أبلغ المستخدمون عن بطء في تسجيل الدخول.
بعد تحقيق أولي.
قد تكون إعدادات تجمع الاتصالات غير مناسبة.إعدادات المحررات
Visual Studio Code
إظهار المحارف البيضاء:
{
"editor.renderWhitespace": "all",
"files.trimTrailingWhitespace": true,
"files.insertFinalNewline": true
}Typora
تفعيل الإظهار:
- Preferences → Editor → Show whitespace
Vim
إظهار المحارف البيضاء:
:set list
:set listchars=space:·,trail:·,eol:¬ناتج HTML
تحويل الفقرات وكسر السطر في Markdown إلى HTML:
فقرة 1
فقرة 2تتحول إلى:
<p>فقرة 1</p>
<p>فقرة 2</p>سطر 1
سطر 2تتحول إلى:
<p>سطر 1<br>
سطر 2</p>قواعد ذات صلة
- قواعد العناوين - بنية الوثيقة
- قواعد التأكيد - تنسيقات النص
- قواعد القوائم - عناصر القوائم
- قواعد الاقتباس - نصوص مقتبسة
تمارين
جرّب إنشاء ما يلي:
- ثلاث فقرات بمواضيع مختلفة
- قصيدة قصيرة (باستخدام كسر صلب)
- كتلة عنوان تحتوي على معلومات اتصال
- نص مركّب يخلط فقرات وكسور أسطر
بعد الانتهاء تأكد من نتيجة العرض وأن التنسيق مطابق للتوقعات.