📄
← العودة للأدلة

دليل صيغة Markdown: مرجع كامل مع أمثلة

· وسوم: markdown-syntax, markdown-guide, markdown-formatting, github-flavored-markdown, markdown-reference

دليل صيغة Markdown

Markdown هي لغة ترميز خفيفة الوزن تحول النص العادي إلى HTML منسق. أنشأها John Gruber في عام 2004، وأصبحت تنسيق الكتابة القياسي للتوثيق وملفات README والمحتوى التقني عبر الويب.

العناوين

استخدم رموز #. رمز # واحد للمستوى الأعلى، وحتى ستة للأعمق:

# Heading 1
## Heading 2
### Heading 3
#### Heading 4

يجب أن تزيد المستويات بمقدار واحد — القفز من ## إلى #### يمكن أن يربك قارئات الشاشة.

تنسيق النص

**Bold text** أو __Bold text__
*Italic text* أو _Italic text_
**_Bold and italic_**
~~Strikethrough text~~

الروابط

[Link text](https://example.com)
[Link with title](https://example.com "Title")
[Reference-style][ref-id]
[ref-id]: https://example.com
<contact@example.com>

الصور

![Alt text](/path/to/image.jpg)
[![Alt text](/path/to/image.jpg)](https://example.com)

النص البديل أمر بالغ الأهمية لإمكانية الوصول و SEO — يظهر عندما تفشل الصور في التحميل.

القوائم

تستخدم القوائم غير المرتبة - أو * أو +. القوائم المرتبة تستخدم الأرقام:

- Item one         1. First item
- Item two         2. Second item
  - Nested item       1. Nested item

التعليمات البرمجية

التعليمات البرمجية المضمنة تستخدم علامات التنصيص الخلفية المفردة: `printf()`.

كتل التعليمات البرمجية تستخدم ثلاث علامات تنصيص خلفية مع معرف لغة اختياري:

```python
def greet(name):
    return f"Hello, {name}!"


اللغات المدعومة: `javascript`، `python`، `html`، `css`، `json`، `bash`، `sql`، `yaml`.

## الاقتباسات

```markdown
> This is a blockquote.
> > Nested blockquotes are supported.

شائعة للتنبيهات والملاحظات والاستشهاد بمصادر خارجية.

الخطوط الأفقية

ثلاث شرطات أو نجوم أو شرطات سفلية أو أكثر على سطر:

---
***
___

الجداول

تحدد الخطوط العمودية والشرطات الأعمدة. تتحكم النقطتان الرأسيتان في المحاذاة:

| Left | Center | Right |
| :--- | :----: | ----: |
| A1   | B1     | C1    |

إضافات GitHub Flavored Markdown

تضيف GitHub Flavored Markdown (GFM) ميزات مفيدة:

- [x] Completed task     # Task lists
- [ ] Incomplete task

:smile: :rocket: :warning:    # Emoji shortcodes

~~Strikethrough text~~        # Strikethrough

تقوم GFM أيضًا بربط URLs تلقائيًا — www.example.com يصبح قابلاً للنقر دون لفه بـ < >.

تهريب الأحرف الخاصة

أضف \ قبل الحرف لعرض أحرف Markdown بشكل حرفي:

\*This is not italic\*
\# This is not a heading

الأحرف التي تحتاج إلى تهريب: \ ` * _ { } [ ] ( ) # + - . ! | ~.

معاينة Markdown عبر الإنترنت

استخدم أداة معاينة Markdown لكتابة ومعاينة Markdown في الوقت الفعلي. يتم تحديث المعاينة المباشرة أثناء الكتابة، لتظهر بالضبط كيف سيتم عرض العناوين والروابط والصور وكتل التعليمات البرمجية والجداول.

دليل صيغة Markdown: مرجع كامل مع أمثلة - CoolTool