Markdown كتل الكود
آخر تحديث: 2026-10-14
كتل الكود نواة CommonMark
ضع الكود بين ثلاثة علامات اقتباس مائلة ``` مع كتابة اسم اللغة لإنشاء كتلة كود مسوَّرة مع تلوين للصيغة. هذه هي الصيغة الأهم في كتابة المستندات التقنية، وجميع أمثلة الأكواد في دروس هذا الموقع تستخدم هذه الطريقة.
| المجموعة | الأساسيات·الكتل |
|---|---|
| مستوى المواصفة | نواة CommonMark |
| إصدار المواصفة | CommonMark 0.31.2 + GFM |
📝 الصيغة
```js
محتوى الكود
```▶ مثال تفاعلي
حرّر Markdown على اليسار وشاهد النتيجة على اليمين
💡 نقاط مهمة
💡 Tip تلوين الصيغة لا يحدث إلا بذكر اسم اللغة: تدعم اللغات الشائعة مثل js وpython وcss وhtml وغيرها.
⚠️ Warning صيغة Markdown داخل السياج لا تُفسَّر إطلاقًا؛ وهذه ميزة عند عرض الشيفرة المصدرية، فإذا أردت عرض علامة النجمة ضع المحتوى داخل كتلة كود.
❓ أسئلة شائعة
س ماذا أفعل إذا كان الكود يحتوي على علامات اقتباس مائلة؟
ج استخدم عددًا أكبر من العلامات كسياج خارجي: إذا كانت الشيفرة تحتوي على 3 علامات، فاستخدم 4 أو أكثر في الخارج.
س كيف أختار بين كتلة الكود بالإزاحة وكتلة الكود المسوَّرة؟
ج يُنصح دائمًا بالسياج: إمكانية ذكر اللغة، دون حاجة إلى إزاحة 4 مسافات، وسلوك أكثر قابلية للتحكم داخل القوائم.
س هل يمكن للمدات ~~~ فتح سياج أيضًا؟
ج نعم، كلٌّ من ``` و ~~~ سياج قياسي، وميزة ~~~ أنها آمنة بطبيعتها حتى مع وجود علامات اقتباس مائلة في المحتوى.
📚 مواضيع ذات صلة
كتل الكود المسننةنواة CommonMark الكود المضمّننواة CommonMark