لإضافة خط أفقي في Markdown، ضع ثلاث شرطات في سطر مستقل، واترك سطرًا فارغًا قبله وبعده:
نهاية القسم الأول.
---
بداية القسم التالي.تظهر النتيجة كفاصل بين فقرتين. تسميه Markdown فاصلًا موضوعيًا، وتمثله HTML بالوسم <hr>. ألصق المثال في عارض Markdown للتحقق من المستند بعد عرضه.
ثلاث طرق لكتابة الفاصل
تنتج جميع هذه الصيغ فاصلًا موضوعيًا:
| مصدر Markdown | النتيجة |
|---|---|
--- |
خط أفقي |
*** |
خط أفقي |
___ |
خط أفقي |
* * * |
خط أفقي |
استخدم ثلاث شرطات أو نجمات أو شرطات سفلية متطابقة على الأقل. يُسمح بالمسافات بين العلامات. لا ينتج خط عند خلط أنواع العلامات أو إضافة نص إلى السطر نفسه أو استخدام علامتين فقط. هذه قواعد من مواصفة الفواصل الموضوعية في CommonMark.
لا يتحكم عدد الشرطات في عرض الخط المرئي. ينتج سطر من 20 شرطة وسطر من ثلاث شرطات عنصر HTML نفسه؛ ويحدد تنسيق الوجهة مظهره.
لماذا تحول الخط الأفقي إلى عنوان؟
هذا المصدر لا يضع فاصلًا أسفل «ملاحظات الإصدار»:
ملاحظات الإصدار
---بل ينشئ عنوانًا من المستوى الثاني. يمكن للشرطات الواقعة مباشرة أسفل نص الفقرة أن تشكّل عنوان Setext، ولهذا التفسير أولوية على الخط الأفقي. أضف سطرًا فارغًا للفصل بينهما:
ملاحظات الإصدار
---غالبًا ما يكون العنوان الصريح أوضح لقسم في مستند:
## ملاحظات الإصدار
تقبل عملية الاستيراد الآن ملفات CSV.استخدم عناوين Markdown لتسمية الأقسام. واستخدم خطًا أفقيًا عندما يكون الانتقال نفسه مهمًا، مثل فصل رسالة عن ملحق.
لماذا يظهر الفاصل كنص عادي؟
تحقق من المصدر المحيط بالخط:
| العَرَض | السبب المحتمل | الإصلاح |
|---|---|---|
تظهر --- داخل كتلة شيفرة |
أربع مسافات في بداية كتلة مستقلة أو سياج شيفرة غير مغلق | أزل المسافة البادئة أو أغلق سياج الشيفرة |
تظهر -- في المعاينة |
شرطتان فقط | استخدم ثلاثًا أو أكثر |
| يظهر نص بجانب العلامات | يحتوي السطر على نص آخر | ضع العلامات في سطر مستقل |
يظهر --- داخل جملة |
العلامات محاطة بعلامات الاقتباس الخلفية | أزل الاقتباس الخلفي إذا أردت فاصلًا |
| تتحول الفقرة السابقة إلى عنوان | لا يوجد سطر فارغ أعلى --- |
أدرج سطرًا فارغًا |
في المستوى الأعلى للمستند، يُسمح بما يصل إلى ثلاث مسافات بادئة للفاصل الموضوعي. داخل القوائم، تحدد المسافة البادئة أيضًا العنصر الذي ينتمي إليه المحتوى؛ لذا افحص القائمة المحيطة بدل حذف كل المسافات.
الخط الأفقي يختلف عن كسر السطر
يفصل الفاصل بين الأقسام. وهو لا ينقل الكلمات التالية إلى سطر جديد فحسب.
استخدم كسر سطر صريحًا للعناوين البريدية:
120 شارع ماركت\
سان فرانسيسكو، كاليفورنيالبدء فقرة جديدة، اترك سطرًا فارغًا. ولفصل الأقسام، ضع --- في سطر مستقل. يشرح دليل كسر السطر في Markdown المسافات النهائية والشرطات المائلة العكسية واختلاف تعامل GitHub مع الأسطر الجديدة في الملفات والتعليقات.
وضع فاصل داخل اقتباس
احتفظ بالبادئة > في كل سطر، بما في ذلك الفاصل والأسطر الفارغة:
> المقترح الأصلي.
>
> ---
>
> سياق إضافي من المراجع.يبقى الفاصل داخل الاقتباس. قد تؤدي إزالة > من الخط إلى إنهاء الاقتباس ونقل الفاصل إلى المستوى الخارجي للمستند. راجع أمثلة الاقتباسات للفقرات المتعددة والاقتباسات المتداخلة.
فاصل الجدول ليس خطًا أفقيًا
ينتمي هذا السطر إلى جدول:
| الصيغة | قابل للتحرير |
| --- | :---: |
| Markdown | نعم |تصف رموز الأنبوب والنقطتان الاختياريتان الأعمدة، ولا تضيف فاصلًا بعرض الصفحة. استخدم مولّد جداول Markdown لإنشاء جدول، أو محوّل CSV إلى Markdown عندما تكون البيانات موجودة بالفعل في جدول بيانات.
الخطوط الأفقية والمستندات المصدّرة
الفاصل الموضوعي ليس أمرًا لفصل الصفحات. يحدد مُصدّر PDF أو Word نهاية الصفحة وفقًا لقواعد التخطيط وترقيم الصفحات. لا تضف شرطات إضافية متوقعًا أن يبدأ القسم التالي في صفحة جديدة.
في صفحة ويب تتحكم في CSS الخاص بها، يمكنك تنسيق <hr> الناتج في ورقة أنماط الموقع. قد لا تسمح خدمة Markdown مستضافة بأنماط CSS مخصصة. افحص الوجهة النهائية أو المستند المصدّر، خصوصًا إذا كان معنى الفاصل يجب أن يبقى واضحًا بعد الطباعة.
أسئلة شائعة
هل أحتاج إلى أسطر فارغة حول الخط الأفقي؟
لا تشترطها CommonMark في كل السياقات، لكن استخدامها يتجنب الالتباس الشائع بين --- والعنوان ويجعل المصدر أسهل قراءة.
هل يمكنني استخدام وسم hr في HTML؟
يعمل <hr> في أدوات العرض التي تسمح بـ HTML الخام. أما --- فهو أنسب لمستند Markdown. يزيل محرر MD File Viewer وسوم HTML التي يُدخلها المستخدم، بينما يعرض صياغة فاصل Markdown بصورة طبيعية.
كيف أعرض ثلاث شرطات دون إنشاء فاصل؟
في مثال للصياغة، استخدم شيفرة مضمنة: `---`. وللنص العادي في سطر مستقل، هرّب الشرطة الأولى: \---.
لأنماط التنسيق الشائعة الأخرى، احتفظ بـ المرجع السريع لـ Markdown في متناولك.
جرّبه في متصفحك
افتح محرر الصفحة الرئيسية لعرض Markdown وتحريره وتصديره فوراً دون تثبيت.