ورقة مرجعية لـ Markdown: مرجع الصياغة مع أمثلة

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

العناوين والفقرات وفواصل الأسطر

تستخدم العناوين من واحد إلى ستة رموز # تليها مسافة؛ عدد أقل من # يعني عنوانًا أكبر. يبدأ السطر الفارغ فقرة جديدة. لفرض فاصل سطر داخل فقرة، أنهِ السطر بمسافتين أو بشرطة مقلوبة.

# Heading 1
### Heading 3

A paragraph.
Line break with two trailing spaces above.

التأكيد والروابط والصور

تميّز النجوم أو الشرطات السفلية النص المائل والعريض، ودمجها يعطي كليهما. تستخدم الروابط الأقواس المربعة للنص والأقواس العادية للرابط؛ وتستخدم الصور نفس الصياغة مع علامة ! في البداية.

*italic*  **bold**  ***bold italic***
[link text](https://example.com)
![alt text](/path/to/image.png)

القوائم والقوائم المتداخلة

تستخدم القوائم غير المرتبة - أو * أو +. تستخدم القوائم المرقّمة أرقامًا تليها نقطة. استخدم مسافتين أو أربع مسافات بادئة لتضمين قائمة داخل أخرى.

- item one
- item two
  - nested item
1. first
2. second

الجداول

يضيف GitHub Flavored Markdown جداول بالخطوط الرأسية. يحدد صف من الشرطات تحت صف العنوان بنية الأعمدة ويمكنه تحديد المحاذاة.

| Name | Type |
| --- | --- |
| Alpha | text |
| Beta | number |

الكود واقتباسات النص والخطوط الأفقية

تميّز علامات الاقتباس العكسي الكود المضمّن، وتفتح ثلاث علامات اقتباس عكسي كتلة مسوّرة، يمكن وسمها بلغة برمجة لتمييز الصياغة اختياريًا. يميّز > في بداية السطر اقتباسًا؛ كرّر عدة > لتضمين اقتباسات متداخلة. ثلاث شرطات أو نجوم أو شرطات سفلية بمفردها في سطر ترسم خطًا أفقيًا.

Use `git status` to check the working tree.

print("hello")

> A quoted sentence.
>> A nested quote.

---

قوائم المهام وتهريب الرموز

يدعم GitHub Flavored Markdown مربعات الاختيار داخل عناصر القوائم. تطبع الشرطة المقلوبة قبل رمز خاص هذا الرمز حرفيًا بدلًا من تفعيل التنسيق. تُسمح أيضًا وسوم HTML الخام ضمن السطر في معظم المحركات، لكن هذه الورقة المرجعية تلتزم بصياغة Markdown البسيطة.

- [x] done
- [ ] not done

Escaped: \* not italic \*

GitHub Flavored Markdown مقابل CommonMark

يحدد CommonMark القواعد الأساسية: العناوين والتأكيد والقوائم والروابط وكتل الكود والاقتباسات. يبني GitHub Flavored Markdown على CommonMark ويضيف الجداول وقوائم المهام والنص المشطوب والربط التلقائي للروابط العادية. عادة يُعرض ملف كُتب لأحدهما بشكل جيد في الآخر، لكن الجداول ومربعات الاختيار تحتاج تحديدًا إلى دعم GitHub Flavored Markdown.

الصياغة الموسّعة: الرياضيات والحواشي والبيانات الأولية والمخططات

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

Inline math: $a^2 + b^2 = c^2$
Block math: $$E = mc^2$$

Text with a note.[^1]
[^1]: The note itself.

---
title: Example document
date: 2026-01-01
---

graph TD
  A --> B
  B --> C

تجميع كل ذلك

اكتب واستعرض مستندًا باستخدام محرر Markdown، وتحقق من مشاكل الصياغة باستخدام Markdown Lint، وأنشئ جدول محتويات باستخدام Markdown TOC. عندما تحتاج ملفًا قابلًا للمشاركة، صدّره باستخدام Markdown إلى PDF أو Markdown إلى Word. لمزيد من التفاصيل حول تحويل ملفات PDF إلى Markdown، راجع دليل PDF إلى Markdown.