ورقة Markdown المرجعية
آخر تحديث
العناوين
ضع مسافة بعد علامات #. عدد العلامات يحدد المستوى، من 1 إلى 6.
| العنصر | Markdown | النتيجة |
|---|---|---|
| عنوان 1 | # Page title | عنوان من المستوى الأعلى، <h1> |
| عنوان 2 | ## Section | عنوان قسم، <h2> |
| عنوان 3 | ### Subsection | عنوان قسم فرعي، <h3> |
| العناوين من 4 إلى 6 | #### Level 4
##### Level 5
###### Level 6 | <h4> و<h5> و<h6> |
| عنوان 1، صيغة بديلة | Page title
========== | <h1>، مثل # Page title تمامًا |
| عنوان 2، صيغة بديلة | Section
------- | <h2>، مثل ## Section تمامًا |
| علامات # ختامية | ## Section ## | <h2>Section</h2>، وعلامات # في النهاية تُحذف |
| مسافة ناقصة | #Not a heading | فقرة عادية. المسافة بعد # إلزامية |
الخط العريض والمائل والمشطوب
النجوم تعمل في أي مكان، حتى داخل الكلمة. أما الشرطات السفلية فلا تعمل إلا عند حدود الكلمات، لذا يبقى snake_case كما كُتب.
| العنصر | Markdown | النتيجة |
|---|---|---|
| خط عريض | **bold text** | خط عريض، <strong>bold text</strong> |
| خط عريض بالشرطات السفلية | __bold text__ | خط عريض، مثل السابق |
| خط مائل | *italic text* | خط مائل، <em>italic text</em> |
| خط مائل بالشرطات السفلية | _italic text_ | خط مائل، مثل السابق |
| عريض ومائل | ***bold and italic*** | <em><strong>bold and italic</strong></em> |
| خط عريض داخل كلمة | un**believ**able | منتصف الكلمة فقط يصبح عريضًا |
| شرطات سفلية داخل كلمة | snake_case_name | نص عادي، دون خط مائل |
| شطب (GFM) | ~~no longer true~~ | نص مشطوب، <del>no longer true</del> |
| تسطير | <ins>underlined</ins> | نص مسطّر. لا توجد في Markdown صيغة للتسطير، لذا هذا HTML |
| تظليل | <mark>highlighted</mark> | نص مظلّل حيث يسمح الموقع بالوسم <mark>. لا توجد في Markdown صيغة للتظليل |
فواصل الأسطر والفقرات
الضغط على Enter مرة واحدة داخل فقرة لا يبدأ سطرًا جديدًا في النتيجة. استخدم إحدى هذه الطرق بدلًا من ذلك.
| العنصر | Markdown | النتيجة |
|---|---|---|
| فقرة جديدة | First paragraph.
Second paragraph. | فقرتان. يفصل بينهما سطر فارغ |
| فاصل: مسافتان | Roses are red,
Violets are blue. | فقرة واحدة فيها <br> بعد red,. ينتهي السطر الأول بمسافتين لا يمكنك رؤيتهما |
| فاصل: شرطة مائلة عكسية | Roses are red,\
Violets are blue. | الوسم <br> نفسه، بعلامة مرئية. يعمل في CommonMark وعلى GitHub |
| فاصل: HTML | Roses are red,<br>Violets are blue. | الوسم <br> نفسه. ويعمل أيضًا داخل خلية جدول |
| سطر جديد واحد | Roses are red,
Violets are blue. | سطر واحد: Roses are red, Violets are blue. تحتفظ مسائل GitHub وتعليقاته بالفاصل، أما ملفات .md فلا |
| أسطر فارغة إضافية | One.
Two. | مثل سطر فارغ واحد. للحصول على مسافة أكبر، ضع <br> في سطر مستقل |
القوائم
أزِح العنصر المتداخل حتى يحاذي نص العنصر الذي فوقه: مسافتان تحت - ، و3 مسافات تحت 1. .
| العنصر | Markdown | النتيجة |
|---|---|---|
| قائمة نقطية | - Apples
- Pears
- Plums | قائمة نقطية، <ul> فيها ثلاثة عناصر <li> |
| رموز نقطية أخرى | * Apples
+ Pears | * و+ تصنعان نقاطًا أيضًا. تغيير الرمز يبدأ قائمة جديدة |
| قائمة مرقمة | 1. Install
2. Configure
3. Run | قائمة مرقمة، <ol> |
| ترقيم كسول | 1. Install
1. Configure
1. Run | تبقى مرقمة 1، 2، 3. الرقم الأول وحده هو المعتبر |
| البدء من رقم معيّن | 7. Seventh
8. Eighth | <ol start="7">، مرقمة بدءًا من 7 |
| قائمة متداخلة | - Fruit
- Apple
- Pear
- Vegetables | قائمة داخل العنصر الأول |
| متداخلة داخل قائمة مرقمة | 1. Download
- Windows
- macOS
2. Install | نقاط داخل الخطوة 1، مُزاحة 3 مسافات |
| فقرة داخل عنصر | - First item
More about the first item.
- Second item | فقرتان داخل العنصر الأول |
| كود داخل عنصر | 1. Run this:
```bash
npm install
```
2. Start the app | كتلة كود داخل الخطوة 1، مُزاحة حتى نص العنصر |
قوائم المهام (مربعات الاختيار)
إضافة من GitHub Flavored Markdown: عنصر القائمة الذي يبدأ بـ[ ] أو [x] يصبح مربع اختيار.
| العنصر | Markdown | النتيجة |
|---|---|---|
| مربع اختيار فارغ | - [ ] Write tests | مربع اختيار غير مؤشَّر |
| مربع اختيار مؤشَّر | - [x] Write tests | مربع اختيار مؤشَّر. و[X] تعمل أيضًا |
| قائمة تحقق | - [x] Draft
- [ ] Review
- [ ] Publish | مربع مؤشَّر ومربعان فارغان. في مسائل GitHub وطلبات السحب يمكنك تأشيرها بنقرة |
| مهام متداخلة | - [ ] Release
- [x] Tag the commit
- [ ] Write the notes | مهمتان فرعيتان تحت المربع الأول |
| مسافة ناقصة | - [] Write tests | نقطة عادية نصها [] Write tests. تحتاج الأقواس المربعة إلى مسافة أو x |
الروابط
يوضع نص الرابط بين قوسين مربعين، والعنوان بين قوسين عاديين بعده مباشرة، دون مسافة بينهما.
| العنصر | Markdown | النتيجة |
|---|---|---|
| رابط مضمّن | [Coddy](https://coddy.tech) | <a href="https://coddy.tech">Coddy</a> |
| رابط مع عنوان توضيحي | [Coddy](https://coddy.tech "Learn to code") | الرابط نفسه. يظهر العنوان كتلميح عند مرور المؤشر |
| عنوان URL بين قوسين زاويين | <https://coddy.tech> | عنوان URL نفسه، كرابط |
| عنوان URL مجرد (GFM) | https://coddy.tech | رابط على GitHub ومواقع GFM الأخرى، التي تحوّل عناوين www. إلى روابط أيضًا. ونص عادي في CommonMark الصارم |
| رابط بريد إلكتروني | <hello@example.com> | رابط mailto: |
| رابط مرجعي | Read the [docs][1].
[1]: https://example.com/docs | docs يصبح رابطًا إلى العنوان. السطر [1]: لا يظهر |
| مرجع مختصر | See [GitHub].
[GitHub]: https://github.com | GitHub يصبح رابطًا إلى العنوان |
| رابط نسبي | [Install guide](docs/install.md) | رابط إلى ملف نسبةً إلى الملف الحالي. على GitHub يفتح الملف داخل المستودع |
| رابط إلى عنوان | [Jump to setup](#getting-started) | ينتقل إلى ## Getting Started في الصفحة نفسها |
| معرّفات العناوين | ## Getting Started! | يحصل على المعرّف getting-started على GitHub: أحرف صغيرة، والمسافات تصبح شرطات، وتُحذف علامات الترقيم عدا - و_ |
| عنوان في ملف آخر | [Requirements](docs/install.md#requirements) | يفتح الملف عند ذلك العنوان |
| مسافات في عنوان URL | [Report](my%20report.pdf) | اكتب كل مسافة على شكل %20، أو ضع عنوان URL بين قوسين زاويين: [Report](<my report.pdf>) |
| الفتح في تبويب جديد | <a href="https://coddy.tech" target="_blank">Coddy</a> | لا توجد في Markdown صيغة لذلك. يعمل HTML حيث يحتفظ الموقع بالخاصية target |
الصور
الصورة رابط تسبقه !. يصبح النص بين القوسين المربعين النص البديل (alt)، الذي تقرؤه قارئات الشاشة بصوت عالٍ.
| العنصر | Markdown | النتيجة |
|---|---|---|
| صورة |  | <img src="cat.png" alt="A cat asleep on a sofa"> |
| صورة مع عنوان توضيحي |  | الصورة نفسها مع تلميح عند مرور المؤشر |
| صورة من عنوان URL |  | تُحمَّل الصورة من الويب |
| صورة مرتبطة برابط | [](https://coddy.tech) | صورة تفتح الرابط عند النقر عليها |
| صورة مرجعية | ![Logo][logo]
[logo]: images/logo.png | مثل الصورة المضمّنة، مع تعريف عنوان URL مرة واحدة في الأسفل |
| حجم الصورة | <img src="logo.png" alt="Logo" width="200"> | الصورة بعرض 200 بكسل. لا توجد في Markdown العادية صيغة للحجم، لذا هذا وسم HTML <img> |
| صورة في المنتصف | <p align="center">
<img src="logo.png" alt="Logo" width="200">
</p> | صورة في منتصف الصفحة، كما في كثير من ملفات README على GitHub |
الكود وكتل الكود
العلامات المائلة (backticks) تحدد الكود داخل السطر، وسياج من ثلاث علامات يحدد كتلة. لا يُنسَّق أي شيء داخل الكود.
| العنصر | Markdown | النتيجة |
|---|---|---|
| كود داخل السطر | Run `npm install` first. | npm install بخط أحادي المسافة، على شكل <code> |
| علامة مائلة داخل الكود | ``Use `git` here`` | الكود Use `git` here. أحِطه بعلامات مائلة أكثر مما يحتوي |
| كتلة كود | ```
npm install
npm run dev
``` | كتلة <pre><code> تحتفظ بفواصل الأسطر |
| تلوين الصيغة | ```python
def greet(name):
return f"Hello, {name}"
``` | كتلة Python بصيغة ملوّنة. الأسماء الشائعة: js وts وpython وbash وjson وhtml وcss وsql |
| سياج بعلامة ~ | ~~~js
console.log("hi");
~~~ | مثل سياج العلامات المائلة تمامًا |
| كود بالإزاحة | const total = 42; | كتلة كود تصنعها إزاحة 4 مسافات، بعد سطر فارغ |
| كتلة diff | ```diff
- const x = 1;
+ const x = 2;
``` | الأسطر المحذوفة بالأحمر والمضافة بالأخضر على GitHub |
| سياج داخل كتلة | ````markdown
```js
let a = 1;
```
```` | كتلة تعرض السياج الداخلي كنص. يحتاج السياج الخارجي إلى علامات مائلة أكثر من الداخلي |
الجداول
إضافة من GitHub Flavored Markdown. السطر الثاني، أي صف الفاصل، يحوّل السطر الأول إلى رأس الجدول. ويجب أن يحتوي على عدد الخلايا نفسه الموجود في الرأس، وإلا فلن يُنشأ جدول.
| العنصر | Markdown | النتيجة |
|---|---|---|
| جدول | | Name | Role |
| ----- | ------ |
| Ada | Admin |
| Linus | Editor | | جدول فيه صف رأس وصفّان |
| محاذاة الأعمدة | | Left | Center | Right |
| :--- | :----: | ----: |
| a | b | c | | النقطتان الرأسيتان تحددان المحاذاة: يسار، وسط، يمين |
| دون الخطوط العمودية الخارجية | Name | Role
--- | ---
Ada | Admin | الجدول نفسه. الخطوط العمودية في بداية السطر ونهايته اختيارية |
| عرض الأعمدة | | a | b |
|---|---|
| 1 | 2 | | العرض يأتي من المحتوى. عدد الشرطات لا يهم، ولا يلزم أن تتحاذى الخطوط العمودية |
| التنسيق داخل الخلايا | | Command | Does |
| --- | --- |
| `git status` | Shows **changed** files | | الكود والخط العريض والروابط والصور كلها تعمل داخل الخلايا |
| خط عمودي داخل خلية | | Operator | Meaning |
| --- | --- |
| `a \| b` | a or b | | تعرض الخلية a | b. هرّب الخط العمودي بكتابته \|، حتى داخل الكود |
| فاصل سطر داخل خلية | | Step | Notes |
| --- | --- |
| 1 | First line<br>Second line | | سطران في خلية واحدة. السطر الجديد الحقيقي سينهي الصف |
| دمج الخلايا | <td colspan="2">Both columns</td> | لا تستطيع جداول Markdown دمج الخلايا. اكتب الجدول بـHTML مع colspan أو rowspan |
الاقتباسات
ابدأ كل سطر بـ>. يمكن أن يحتوي الاقتباس على أي Markdown آخر.
| العنصر | Markdown | النتيجة |
|---|---|---|
| اقتباس | > Simple is better than complex. | اقتباس مُزاح، <blockquote> |
| عدة فقرات | > First paragraph.
>
> Second paragraph. | اقتباس واحد فيه فقرتان. السطر الذي لا يحتوي إلا > يبقيهما معًا |
| اقتباس متداخل | > The reply
>> The original message | اقتباس داخل اقتباس |
| عناصر أخرى بداخله | > #### Note
> - Back up first
> - Then upgrade | عنوان وقائمة داخل الاقتباس |
| تنبيه (GitHub) | > [!NOTE]
> Requires Node 20 or later. | مربع ملاحظة ملوّن على GitHub. الأنواع الأخرى هي [!TIP] و[!IMPORTANT] و[!WARNING] و[!CAUTION] |
الخطوط الأفقية
ثلاث شرطات أو نجوم أو شرطات سفلية أو أكثر وحدها في سطر ترسم خطًا عبر الصفحة.
| العنصر | Markdown | النتيجة |
|---|---|---|
| خط | --- | خط أفقي، <hr> |
| صيغ أخرى | ***
___ | خطّان آخران |
| خط بعد نص | Some text
--- | فقرة، ثم خط. احتفظ بالسطر الفارغ |
| سطر فارغ ناقص | Some text
--- | عنوان من المستوى 2، وليس خطًا: --- تحت سطر من النص تجعله عنوانًا |
الحواشي
مدعومة على GitHub وGitLab وكثير من مولّدات المواقع الثابتة. لا توجد حواشٍ في CommonMark الصارم.
| العنصر | Markdown | النتيجة |
|---|---|---|
| حاشية | Markdown dates from 2004.[^1]
[^1]: John Gruber created it, with Aaron Swartz. | رقم 1 مرتفع يشير إلى الملاحظة، وتُسرد الملاحظة في أسفل الصفحة |
| حاشية مسماة | See the spec.[^spec]
[^spec]: https://spec.commonmark.org | يمكن أن تكون التسميات كلمات، لكن الملاحظات تبقى مرقمة 1، 2، 3 بترتيب استخدامها |
| أين تُعرَّف | [^1]: The text of the note. | يمكن أن يوضع التعريف في أي مكان في الملف. ويُعرض دائمًا في النهاية |
تهريب المحارف (Escaping)
الشرطة المائلة العكسية قبل علامة ترقيم تطبع العلامة نفسها بدلًا من التنسيق.
| العنصر | Markdown | النتيجة |
|---|---|---|
| نجوم حرفية | \*not italic\* | نص عادي بالنجوم: *not italic* |
| علامة # حرفية | \# Not a heading | فقرة تبدأ بـ# |
| رقم ونقطة | 2024\. A good year. | فقرة، وليست قائمة تبدأ من 2024 |
| أقواس حرفية | \[not a link\](page.md) | الأقواس المربعة والعادية كما كُتبت |
| علامة مائلة حرفية | \` | علامة مائلة واحدة |
| شرطة مائلة عكسية حرفية | \\ | شرطة مائلة عكسية واحدة |
| ما يمكن تهريبه | \ ` * _ {} [] () <> # + - . ! | | أي علامة ترقيم ASCII. والشرطة المائلة العكسية قبل حرف أو رقم تبقى شرطة مائلة عكسية |
| كيانات HTML | © 2026 & <div> | © 2026 & <div>، كنص |
| لا تهريب داخل الكود | `*stars*` | الكود *stars* كما كُتب. داخل الكود تكون الشرطة المائلة العكسية محرفًا عاديًا |
HTML داخل Markdown
معظم أدوات العرض تمرّر HTML كما هو، لذا يغطي الوسم ما لا توجد له صيغة في Markdown. يحذف GitHub وسوم HTML غير الآمنة مثل <script> و<style> و<iframe> والخاصية style.
| العنصر | Markdown | النتيجة |
|---|---|---|
| مفاتيح لوحة المفاتيح | Press <kbd>Ctrl</kbd> + <kbd>C</kbd> | Ctrl وC مرسومتان كمفاتيح |
| نص سفلي وعلوي | H<sub>2</sub>O and x<sup>2</sup> | H₂O وx² |
| قسم قابل للطي | <details>
<summary>Show the answer</summary>
The answer is **42**.
</details> | قسم يُفتح بالنقر. الأسطر الفارغة تسمح بعرض Markdown الموجودة بداخله |
| Markdown داخل كتلة HTML | <div>
**not bold**
</div> | **not bold** كما كُتب. لا تُقرأ Markdown داخل كتلة HTML حتى ينهي سطر فارغ الكتلة |
| نص ملوّن | <span style="color: red">red</span> | نص أحمر في المواقع التي تسمح بالأنماط المضمّنة. يحذف GitHub الخاصية style |
التعليقات
لا توجد في Markdown صيغة للتعليقات. حيلتان تُبقيان النص خارج الصفحة المعروضة.
| العنصر | Markdown | النتيجة |
|---|---|---|
| تعليق مخفي | [//]: # (This line is never shown) | لا شيء. السطر تعريف رابط لا يستخدمه أي رابط، لذا لا يصل أبدًا إلى HTML |
| صيغة بديلة | [comment]: <> (Also hidden) | لا شيء، بالحيلة نفسها |
| تعليق HTML | <!-- TODO: add screenshots --> | لا شيء على الصفحة، لكن التعليق يبقى في مصدر HTML |
| تعليق متعدد الأسطر | <!--
This whole block
is hidden
--> | لا شيء على الصفحة |
| الموضع | Some text.
[//]: # (comment)
More text. | فقرتان. يحتاج سطر التعليق إلى سطر فارغ قبله، وإلا ظهر كنص |
GitHub Flavored Markdown وإضافات GitHub
GitHub Flavored Markdown (GFM) هي CommonMark مضافًا إليها الجداول وقوائم المهام والشطب وروابط العناوين المجردة. ويضيف GitHub المزيد فوقها.
| الميزة | Markdown | أين تعمل |
|---|---|---|
| الجداول | | a | b |
| --- | --- |
| 1 | 2 | | GFM: GitHub وGitLab ومعظم أدوات التوثيق |
| قوائم المهام | - [x] Done | GFM |
| الشطب | ~~text~~ | GFM |
| روابط العناوين المجردة | www.coddy.tech | GFM |
| كود مع اسم اللغة | ```js
let a = 1;
``` | CommonMark وGFM. الألوان يحددها الموقع |
| الحواشي | Text.[^1]
[^1]: Note. | GitHub وGitLab، مع أنها ليست في مواصفة GFM |
| الرموز التعبيرية | :rocket: :tada: | يحوّل GitHub وGitLab الرموز المختصرة إلى رموز تعبيرية |
| الإشارات | @octocat | GitHub: يضع رابطًا إلى المستخدم ويرسل له إشعارًا |
| روابط المسائل | #123 | GitHub: رابط إلى المسألة أو طلب السحب رقم 123 في المستودع نفسه |
| المخططات | ```mermaid
graph LR
A --> B
``` | يرسم GitHub وGitLab مخطط Mermaid |
| الرياضيات | $E = mc^2$
$$
\sum_{i=1}^{n} i
$$ | يعرض GitHub صيغ LaTeX الرياضية، داخل السطر بين علامتي $ وككتلة بين سطرين من $$ |
كل صيغ Markdown على صفحة واحدة، بجانب ما تتحول إليه كل صيغة. تغطي ورقة Markdown المرجعية هذه الصيغة الأساسية (العناوين، والتأكيد، وفواصل الأسطر، والقوائم، والروابط، والصور، والكود، والاقتباسات) وإضافات GitHub Flavored Markdown: الجداول مع المحاذاة، وقوائم المهام، والشطب، وروابط العناوين المجردة، والحواشي، إضافة إلى تهريب المحارف وHTML والتعليقات.
تتبع الأمثلة CommonMark وGitHub Flavored Markdown، وهي القواعد التي يبني عليها GitHub وGitLab ومعظم أدوات التوثيق. وحيث يتصرف موقع ما بشكل مختلف، يذكر الصف ذلك. لتشاهد أي مثال وهو يُعرض أثناء الكتابة، الصقه في محرر Markdown.
الأسئلة الشائعة حول ورقة Markdown المرجعية
كيف أنشئ جدولًا في Markdown؟
| Name | Role | و| --- | --- | و| Ada | Admin |. النقطتان الرأسيتان في صف الفاصل تحددان محاذاة العمود: :--- لليسار، و:---: للوسط، و---: لليمين. الجداول ميزة من GitHub Flavored Markdown، لذا تعمل على GitHub وGitLab ومعظم أدوات التوثيق، لكنها لا تعمل في CommonMark الصارم.كيف أضيف سطرًا جديدًا في Markdown؟
\)، أو اكتب <br>. ولبدء فقرة جديدة، اترك سطرًا فارغًا. الاستثناء هو مسائل GitHub وتعليقاته: هناك يظهر السطر الجديد الواحد كفاصل سطر أصلًا.كيف أكتب تعليقًا في Markdown؟
[//]: # (your comment) في سطر مستقل، يسبقه سطر فارغ، هو تعريف رابط لا يستخدمه شيء، لذا لا يصل أبدًا إلى الصفحة ولا إلى HTML. وتعليق HTML، <!-- your comment -->، مخفي أيضًا على الصفحة لكنه يبقى في مصدر HTML، حيث يستطيع قراءته أي شخص يعرض المصدر.كيف أنشئ كتلة كود في Markdown؟
```python، لتحصل على تلوين الصيغة. وللكود داخل جملة، أحِطه بعلامة مائلة واحدة: `npm install`.كيف أضيف مربع اختيار في Markdown؟
[ ] لمربع فارغ أو [x] لمربع مؤشَّر: - [ ] Review أو - [x] Draft. احتفظ بالمسافة داخل القوسين الفارغين. مربعات الاختيار جزء من GitHub Flavored Markdown، وفي مسائل GitHub وطلبات السحب يمكنك تأشيرها بنقرة.كيف أغيّر حجم صورة في Markdown؟
 تعرض الصورة دائمًا بحجمها الأصلي. استخدم وسم HTML بدلًا من ذلك، مثل <img src="image.png" alt="alt text" width="300">، الذي يقبله GitHub ومعظم أدوات العرض. اضبط العرض وحده أو الارتفاع وحده للحفاظ على التناسب.كيف أضع رابطًا إلى عنوان في Markdown؟
#: [Setup](#getting-started) ينتقل إلى ## Getting Started. يبني GitHub المعرّف من نص العنوان بأحرف صغيرة، مع تحويل المسافات إلى شرطات وحذف علامات الترقيم عدا الشرطات والشرطات السفلية. ولعنوان في ملف آخر، ضع المعرّف بعد اسم الملف: [Setup](docs/install.md#getting-started).ما هو ملف .md؟
.md و.markdown، وREADME.md هو الملف الذي يعرضه GitHub في الصفحة الرئيسية للمستودع. يفتحه أي محرر نصوص، ويعرضه GitHub ومواقع التوثيق وعارضات Markdown كنص منسّق. لترى الملف معروضًا أثناء تعديله، الصقه في محرر Markdown.