عينة Markdown

دليل شامل لنحو Markdown

يوضح هذا المستند جميع البنى النحوية الرئيسية المتوفرة في Markdown.

الرؤوس

الرأس H1

الرأس H2

الرأس H3

الرأس H4

الرأس H5

الرأس H6

بديل H1

بديل H2

تنسيق النص

النص الغامق باستخدام النجوم النص الغامق باستخدام التسطير السفلي

النص المائل باستخدام النجوم النص المائل باستخدام التسطير السفلي

النص الغامق والمائل باستخدام النجوم النص الغامق والمائل باستخدام التسطير السفلي

نص مشطوب

Inline code

نص عادي مع غامق, مائل, و كود مجتمع معًا.

القوائم

القوائم غير المرتبة

• العنصر 1
• العنصر 2
  • العنصر المتداخل 2.1
  • العنصر المتداخل 2.2
    • العنصر المتداخل بعمق 2.2.1
• العنصر 3

صيغة بديلة:

• العنصر أ
• العنصر ب
  • العنصر المتداخل ب.1
  • العنصر المتداخل ب.2

صيغة أخرى:

• العنصر س
• العنصر ص
  • العنصر المتداخل ص.1

القوائم المرتبة

1. العنصر الأول
2. العنصر الثاني
   1. عنصر مرقم متداخل
   2. عنصر متداخل آخر
      1. عنصر متداخل بعمق
3. العنصر الثالث

ترقيم بديل:

1. العنصر واحد
2. العنصر اثنين (مرقم تلقائيًا)
3. العنصر ثلاثة (مرقم تلقائيًا)

قوائم مختلطة

1. عنصر مرتب
   • عنصر متداخل غير مرتب
   • عنصر متداخل غير مرتب آخر
2. عنصر مرتب آخر
   1. عنصر مرتب متداخل
   2. عنصر مرتب متداخل آخر

قوائم المهام

• مهمة مكتملة
• مهمة غير مكتملة
• مهمة مكتملة أخرى
  • مهمة متداخلة مكتملة
  • مهمة متداخلة غير مكتملة

الروابط والصور

الروابط

رابط بسيط

رابط مع عنوان

// TODO قم بإيقاف تشغيل MDX < https://www.autolink.com>

رابط مرجعي

رابط مرجعي آخر

رابط مرجعي حساس لحالة الحروف

يمكنك أيضًا الارتباط بـ ملفات محلية.

الصور

تعريفات مرجعية

الكود

الكود داخل النص

استخدم console.log() للطباعة إلى وحدة التحكم.

كتل الكود

Simple code block without syntax highlighting

// JavaScript code block
function greet(name) {
  console.log(`Hello, ${name}!`);
}

greet("World");

# Python code block
def fibonacci(n):
    if n <= 1:
        return n
    return fibonacci(n-1) + fibonacci(n-2)

print(fibonacci(10))

# Bash script
#!/bin/bash
echo "Hello, World!"
for i in {1..5}; do
    echo "Number: $i"
done

{
  "name": "Sample JSON",
  "version": "1.0.0",
  "dependencies": {
    "express": "^4.18.0"
  }
}

كتلة كود تحوي 4 مسافات: TODO: أصلح هذه المشكلة

الجداول

العمود 1	العمود 2	العمود 3
الصف 1	البيانات	المزيد من البيانات
الصف 2	المعلومات	التفاصيل

جدول بمحاذاة

محاذاة لليسار	محاذاة للوسط	محاذاة لليمين
يسار	وسط	يمين
النص	النص	النص
المزيد	البيانات	هنا

جدول بسيط

العنوان الأول	العنوان الثاني
خلية المحتوى 1	خلية المحتوى 2
خلية المحتوى 3	خلية المحتوى 4

الاقتباسات

هذا اقتباس بسيط.

هذا اقتباس يمتد على عدة أسطر.

اقتباسات متداخلة:

هذا اقتباس متداخل.

وهذا اقتباس متداخل بعمق.

اقتباس مع عناصر أخرى

• عنصر قائمة داخل الاقتباس
• عنصر آخر

النص الغامق داخل الاقتباس مع كود داخلي.

الفواصل الأفقية

---

---

---

---

---

---

فواصل الأسطر

هذه هي السطر الأول.
هذه هي السطر الثاني (مسافتان في نهاية السطر السابق).

هذا هو السطر الثالث.

هذا هو السطر الرابع (السطر الفارغ ينشئ فاصل فقرة).

هذه سطر مع
فاصل بالسلاش الخلفي.

عناصر HTML

يمكنك استخدام علامات HTML في Markdown.

النص الغامق باستخدام HTML

الكود الداخلي باستخدام HTML

Ctrl + C

النص المميز

النص الصغير

_{النص المنخفض} و ^{النص المرتفع}

Expandable section

يتم إخفاء هذا المحتوى افتراضيًا ويمكن توسيعه.

• عنصر قائمة
• عنصر آخر

console.log("Code in details");

المزايا المتقدمة

الحواشي السفلية

إليك جملة مع حاشية سفلية[^1].

جملة أخرى مع حاشية سفلية[^note].

قوائم التعريف

المصطلح 1 : تعريف للمصطلح 1

المصطلح 2 : تعريف للمصطلح 2 : تعريف آخر للمصطلح 2

الاختصارات

\_\[HTML]: لغة توصيف النص التشعبي \_\[CSS]: أوراق الأنماط المتتالية

HTML وCSS هما تقنيات ويب مهمة.

الرياضيات (في حال كانت مدعومة)

رياضيات داخلية: $E = mc^2$

رياضيات الكتلة:

$$ \int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi} $$

أحرف الهروب

استخدم الشرطة المائلة العكسية للهروب من الأحرف الخاصة:

\*ليس مائلًا\* \#ليس عنوانًا \[ليس رابطًا] \`ليس كودًا\`

التعليقات

الإيموجي

\:ابتسامة: \:قلب: \:إبهام للأعلى: \:صاروخ: \:كمبيوتر:

😀 😍 👍 🚀 💻

---

تنبيهات GitHub في Markdown

يدعم GitHub تنبيهات مخصصة في ملفات Markdown، والتي يمكن استخدامها لتسليط الضوء على المعلومات الهامة أو التحذيرات. فيما يلي أمثلة عن كيفية استخدامها:

[!NOTE] معلومات مفيدة يجب على المستخدمين معرفتها، حتى عند تصفح المحتوى بسرعة.

[!TIP] نصائح مفيدة للقيام بالأشياء بشكل أفضل أو أكثر سهولة.

[!IMPORTANT] معلومات أساسية يجب على المستخدمين معرفتها لتحقيق هدفهم.

[!WARNING] معلومات عاجلة تتطلب اهتمام المستخدم الفوري لتجنب المشاكل.

[!CAUTION] إرشادات حول المخاطر أو النتائج السلبية لبعض الإجراءات.

الخاتمة

يغطي هذا المستند معظم قواعد صياغة Markdown القياسية. بعض الميزات مثل الحواشي السفلية وقوائم التعريف والرياضيات وبعض عناصر HTML قد لا تكون مدعومة في جميع معالجات Markdown، لكنها تعمل في العديد من الإصدارات الموسعة مثل GitHub Flavored Markdown (GFM) وCommonMark وغيرها.

ملاحظة: قد يختلف العرض الدقيق لهذه العناصر اعتمادًا على معالج Markdown المستخدم.