انتقل إلى المحتوى الرئيسي
الرئيسيةالمدونةالتسطير في Markdown: ما يعمل على GitHub وأدوات العرض الأخرى

التسطير في Markdown: ما يعمل على GitHub وأدوات العرض الأخرى

لا تملك Markdown صياغة أصلية للتسطير. تعرّف على متى يعمل <ins> و<u> ولماذا يجعل __text__ النص عريضًا وكيف تختار بديلًا قابلًا للنقل.

تاريخ النشر:

لا تملك Markdown صياغة أصلية لتسطير النص. في CommonMark وGitHub Flavored Markdown، تعني _نص_ نصًا مائلًا وتعني __نص__ نصًا عريضًا. يحتاج التسطير عادة إلى دعم HTML أو امتداد خاص بالتطبيق.

الصيغة الموثقة على GitHub هي:

<ins>الموعد النهائي المعدّل</ins> هو الجمعة.

تدرج GitHub الصيغة <ins>...</ins> للنص المسطر في وثائق التنسيق الأساسي. هذا خيار HTML تدعمه المنصة، وليس علامة Markdown جديدة تعمل في كل مكان.

مقارنة التسطير والخط العريض والمائل

المصدر المعنى البيئات المتوقعة
_مهم_ تأكيد، عادة بخط مائل CommonMark وGFM
__مهم__ تأكيد قوي، عادة بخط عريض CommonMark وGFM
**مهم** تأكيد قوي، عادة بخط عريض CommonMark وGFM
<ins>نص مضاف</ins> نص مُدرج، عادة مسطر أدوات العرض التي تدعم HTML؛ موثق لدى GitHub
<u>نص مشروح</u> تعليق توضيحي في HTML، عادة مسطر أدوات العرض التي تسمح بهذا العنصر

اختر الخط العريض أو المائل عندما يكون الهدف هو التأكيد. مثلًا، تبقى **الموعد الجمعة** مفيدة في README أو ملاحظة أو تصدير Markdown دون الاعتماد على HTML الخام.

ما الفرق بين ins وu؟

قد يتشابه مظهر الوسمين، لكن معناهما مختلف.

يمثل <ins> نصًا أُضيف إلى مستند. وهو مناسب لتعديل مثل إضافة متطلب جديد. يسطّره المتصفح عادة، لكن ورقة الأنماط تستطيع تغيير مظهره. راجع مرجع النص المُدرج في MDN.

يدعم الإصدار <ins>استيراد CSV وTSV</ins>.

يحدد <u> تعليقًا توضيحيًا لا يُعد تأكيدًا عاديًا، مثل الإشارة إلى خطأ إملائي. لا تعرّفه HTML الحديثة كوسم عام لجعل شيء «مهمًا». راجع مرجع العنصر u في MDN.

يرجى مراجعة تهجئة <u>recieve</u>.

إذا كنت تتحكم في موقع وتحتاج إلى تسطير بصري فقط، فاستخدم text-decoration: underline في CSS. قد تزيل منصة Markdown مستضافة سمات الأنماط أو تمنع الأنماط المخصصة، لذا ليست هذه الطريقة قابلة للنقل دائمًا أيضًا.

لماذا يعمل التسطير في محرر ويختفي في آخر؟

توجد ثلاثة قرارات منفصلة: يتعرف محلل Markdown على HTML، ويحدد التطبيق الوسوم المسموحة، وتحدد ورقة أنماط الوجهة مظهر العناصر المقبولة. دعم GFM لا يضمن السماح بكل وسوم HTML.

يزيل محرر MD File Viewer حاليًا وسوم HTML الخام من إدخال المستخدم. عند لصق <ins>نص مضاف</ins> أو <u>نص مشروح</u>، تبقى الكلمات دون الوسوم، فلا تظهر مسطرة في المعاينة. استخدم المعاينة لتنسيقات Markdown المدعومة، وتحقق من التنسيق المعتمد على HTML في وجهة النشر الفعلية.

إذا كنت تنقل مستند HTML إلى Markdown، يساعد محوّل HTML إلى Markdown في استعادة النص والعناوين والروابط والقوائم. قد يضيع التسطير وCSS المخصص لأن Markdown العادية لا تملك صياغة مقابلة. تحقق من النتيجة قبل استبدال المستند الأصلي.

أمثلة GitHub README

لإضافة قصيرة في ملاحظة تغيير، يكون خيار HTML الموثق لدى GitHub:

يضيف هذا الإصدار <ins>خطوة استيراد اختيارية</ins>.

للموعد النهائي أو المتطلب، استخدم تأكيد Markdown:

**مطلوب:** أدرج صف رأس في ملف CSV.

للوجهة، استخدم رابطًا:

[اقرأ تعليمات الاستيراد](https://example.com/import)

قد يبدو النص المسطر كرابط قابل للنقر. تجنب جعل التسميات العادية تبدو تفاعلية، خصوصًا حين تحتوي الفقرة نفسها على روابط فعلية. يشرح دليل روابط Markdown النص الوصفي للروابط والروابط المرجعية.

أخطاء شائعة في التسطير

الشرطتان السفليتان تجعل النص عريضًا. تغيير **كلمة** إلى __كلمة__ يغير العلامة لا المعنى؛ فكلاهما يمثل تأكيدًا قويًا.

علامات الاقتباس الخلفية تعرض الوسم كشيفرة. كتابة `<ins>نص</ins>` مفيدة في درس، لكنها تعرض العلامة عمدًا بدل تطبيقها.

اختصارات لوحة المفاتيح تخص التطبيق. قد يوفر محرر النص المنسق أمر تسطير ويحفظ HTML أو صيغة مستند خاصة به. هذا لا يجعل التسطير جزءًا من Markdown القابلة للنقل.

العنوان ذو الخط السفلي مفهوم مختلف. في هذا المصدر، تنشئ الشرطات عنوانًا من المستوى الثاني:

ملاحظات الإصدار
-------------

ولا تسطّر عبارة داخل فقرة. للفصل بين الأقسام، استخدم خطًا أفقيًا في Markdown مع أسطر فارغة حوله.

أسئلة شائعة

كيف أسطّر النص في Markdown على GitHub؟

استخدم <ins>نص</ins>، وهي الصيغة التي توثقها GitHub للتسطير. وللتأكيد الذي يعمل أيضًا دون دعم HTML، استخدم **نص** أو *نص* بدلًا منها.

هل يوجد بديل للتسطير يعتمد على Markdown وحدها؟

لا توجد علامة تسطير قياسية. تضيف بعض التطبيقات صياغة خاصة بها، لكن عليك مراجعة وثائقها والصيغة المستخدمة عند التصدير.

هل يبقى التسطير بعد تحويل Markdown إلى PDF أو Word؟

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

يوفر المرجع السريع لـ Markdown ملخصًا للتنسيقات التي لها صياغة Markdown مخصصة.

جرّبه في متصفحك

افتح محرر الصفحة الرئيسية لعرض Markdown وتحريره وتصديره فوراً دون تثبيت.

مقالات أخرى

التسطير في Markdown: ما يعمل على GitHub وأدوات العرض الأخرى | عارض ملفات MD