LANG://

صيغة MDC

قواعد كتابة المكونات داخل الماركداون.

الكتل والعناصر المضمنة والتداخل

  • ::name = مكون كتلة (المحتوى الافتراضي هو نص الماركداون)
  • :name = عنصر مضمن يغلق نفسه
  • :::name = كتلة متداخلة داخل كتلة (أضف نقطتين لكل مستوى تداخل)
  • يجب أن يتطابق عدد النقطتين في الفتح والإغلاق

:name

::name::name

:::name:::name

الخصائص

الخصائص المضمنة تستخدم الصيغة {key="value"} بعد اسم المكون:

::card{title="بطاقة" icon="i-lucide-sparkles" to="/ar/docs"}

خصائص YAML متعددة الأسطر توضع بين --- بعد علامة الفتح:

::card
---
title: بطاقة
icon: i-lucide-sparkles
to: /ar/docs
---
محتوى البطاقة.
::

الخصائص المنطقية تكون باسم فقط (required). الخصائص المرتبطة بالبيانات الوصفية تستخدم :prop="frontmatterKey".

الفتحات المسماة

استخدم #slot-name في سطر منفصل داخل الكتلة:

::card
#header
محتوى الرأس
#footer
محتوى التذييل
::

السمات المضمنة

أضف كلاسات ومعرفات وأنماط لأي عنصر مضمن:

[نص]{.class #id style="color:red"}
`كود`{color="error"}
**عريض**{.text-primary}
:icon{name="i-lucide-star"}
```{lang="md"}

## المغلفات العامة

استخدم `::div` لتنسيقات مخصصة:

```md
::div{class="grid md:grid-cols-2 gap-4"}
عمود 1
عمود 2
::

إضافات كتلة الكود

كتل الكود المسورة تدعم تسمية الملف وتمييز الأسطر:

```ts [example.ts]
function hello() {
  console.log('world')
}
```

تمييز الأسطر باستخدام {3,5-7} بعد علامة اللغة. استخدم 4 علامات تنصيص عندما تحتاج لعرض 3 علامات تنصيص حرفياً.