# ورقة مرجعية لـ Markdown: مرجع الصياغة مع أمثلة

> يسرد هذا المرجع كل عنصر شائع في Markdown مع شرح مبسط من سطر واحد ومثال قصير قابل للنسخ في كتلة كود.

- الصفحة: https://acepdfmd.com/ar/guides/markdown-cheat-sheet/
- آخر تحديث: 2026-09-14
- يعمل على: https://acepdfmd.com (تُحذف الملفات المرفوعة خلال 60 دقيقة. لا حاجة للتسجيل للاستخدام الخفيف.)
- متوفر أيضًا بـ 29 لغة: https://acepdfmd.com/<lang>/guides/markdown-cheat-sheet/

## العناوين والفقرات وفواصل الأسطر

تستخدم العناوين من واحد إلى ستة رموز `#` تليها مسافة؛ عدد أقل من `#` يعني عنوانًا أكبر. يبدأ السطر الفارغ فقرة جديدة. لفرض فاصل سطر داخل فقرة، أنهِ السطر بمسافتين أو بشرطة مقلوبة.

```
# Heading 1
### Heading 3

A paragraph.
Line break with two trailing spaces above.
```

## التأكيد والروابط والصور

تميّز النجوم أو الشرطات السفلية النص المائل والعريض، ودمجها يعطي كليهما. تستخدم الروابط الأقواس المربعة للنص والأقواس العادية للرابط؛ وتستخدم الصور نفس الصياغة مع علامة `!` في البداية.

```
*italic*  **bold**  ***bold italic***
[link text](https://example.com)
![alt text](https://acepdfmd.com/ar/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.
```

```python
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
---
```

```mermaid
graph TD
  A --> B
  B --> C
```

## تجميع كل ذلك

اكتب واستعرض مستندًا باستخدام [محرر Markdown](https://acepdfmd.com/ar/tool/markdown-editor/)، وتحقق من مشاكل الصياغة باستخدام [Markdown Lint](https://acepdfmd.com/ar/tool/markdown-lint/)، وأنشئ جدول محتويات باستخدام [Markdown TOC](https://acepdfmd.com/ar/tool/markdown-toc/). عندما تحتاج ملفًا قابلًا للمشاركة، صدّره باستخدام [Markdown إلى PDF](https://acepdfmd.com/ar/tool/markdown-to-pdf/) أو [Markdown إلى Word](https://acepdfmd.com/ar/tool/markdown-to-word/). لمزيد من التفاصيل حول تحويل ملفات PDF إلى Markdown، راجع [دليل PDF إلى Markdown](https://acepdfmd.com/ar/guides/pdf-to-markdown-guide/).

## الأدوات المذكورة في هذا الدليل

- [محرر Markdown والمعاينة](https://acepdfmd.com/ar/tool/markdown-editor/): فتح وكتابة وتحرير Markdown مع معاينة غنية مباشرة (جداول، صور، قوائم مهام)، تصدير إلى .md أو PDF أو Word أو HTML.
- [فحص وتنسيق Markdown](https://acepdfmd.com/ar/tool/markdown-lint/): صحّح الفراغات والعناوين والقوائم والجداول إلى نمط موحّد مع تقرير بما تغيّر.
- [جدول محتويات Markdown](https://acepdfmd.com/ar/tool/markdown-toc/): إنشاء وإدراج جدول محتويات مرتبط تلقائيًا من عناوينك.
- [Markdown إلى PDF](https://acepdfmd.com/ar/tool/markdown-to-pdf/): تحويل ملف .md إلى PDF منسّق.
- [Markdown إلى Word](https://acepdfmd.com/ar/tool/markdown-to-word/): تحويل ملف .md إلى DOCX قابل للتحرير.

## أدلة أخرى

- [أحجام وأبعاد صفحات PDF: A4 و Letter و Legal والمزيد](https://acepdfmd.com/ar/guides/pdf-page-sizes/)
- [كيف يعمل ضغط PDF ولماذا لا تتقلص بعض الملفات إلا قليلًا](https://acepdfmd.com/ar/guides/pdf-compression-guide/)
- [من PDF إلى Markdown: كيف يعمل وكيف تستخدمه للذكاء الاصطناعي](https://acepdfmd.com/ar/guides/pdf-to-markdown-guide/)
- [التعرف الضوئي على الحروف لملفات PDF والصور: كيف تحصل على نص دقيق](https://acepdfmd.com/ar/guides/ocr-guide/)
- [هل من الآمن رفع ملف PDF عبر الإنترنت؟ دليل الخصوصية](https://acepdfmd.com/ar/guides/privacy-guide/)
- [فتح وتحويل ملفات Apple iWork (Pages وNumbers وKeynote) بدون جهاز Mac](https://acepdfmd.com/ar/guides/iwork-guide/)
- [دليل أدوات JSON: تحويل المستندات والبيانات إلى JSON والعودة منه](https://acepdfmd.com/ar/guides/json-guide/)
