Menu
Coddy logo textTech
flag Ar iconالعربيةdown icon

ورقة 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
فاصل: HTMLRoses 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/docsdocs يصبح رابطًا إلى العنوان. السطر [1]: لا يظهر
مرجع مختصرSee [GitHub]. [GitHub]: https://github.comGitHub يصبح رابطًا إلى العنوان
رابط نسبي[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النتيجة
صورة![A cat asleep on a sofa](cat.png)<img src="cat.png" alt="A cat asleep on a sofa">
صورة مع عنوان توضيحي![Logo](logo.png "Coddy logo")الصورة نفسها مع تلميح عند مرور المؤشر
صورة من عنوان URL![Build status](https://example.com/badge.svg)تُحمَّل الصورة من الويب
صورة مرتبطة برابط[![Logo](logo.png)](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&copy; 2026 &amp; &lt;div&gt;© 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] DoneGFM
الشطب~~text~~GFM
روابط العناوين المجردةwww.coddy.techGFM
كود مع اسم اللغة```js let a = 1; ```CommonMark وGFM. الألوان يحددها الموقع
الحواشيText.[^1] [^1]: Note.GitHub وGitLab، مع أنها ليست في مواصفة GFM
الرموز التعبيرية:rocket: :tada:يحوّل GitHub وGitLab الرموز المختصرة إلى رموز تعبيرية
الإشارات@octocatGitHub: يضع رابطًا إلى المستخدم ويرسل له إشعارًا
روابط المسائل#123GitHub: رابط إلى المسألة أو طلب السحب رقم 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؟
لا توجد في Markdown صيغة للتعليقات، لكن هناك حيلتين تعملان. [//]: # (your comment) في سطر مستقل، يسبقه سطر فارغ، هو تعريف رابط لا يستخدمه شيء، لذا لا يصل أبدًا إلى الصفحة ولا إلى HTML. وتعليق HTML، <!-- your comment -->، مخفي أيضًا على الصفحة لكنه يبقى في مصدر HTML، حيث يستطيع قراءته أي شخص يعرض المصدر.
كيف أنشئ كتلة كود في Markdown؟
ضع ثلاث علامات مائلة (backticks) في السطر الذي قبل الكود وثلاثًا في السطر الذي بعده. أضف اسم اللغة بعد العلامات الافتتاحية، كما في ```python، لتحصل على تلوين الصيغة. وللكود داخل جملة، أحِطه بعلامة مائلة واحدة: `npm install`.
كيف أضيف مربع اختيار في Markdown؟
ابدأ عنصر القائمة بـ[ ] لمربع فارغ أو [x] لمربع مؤشَّر: - [ ] Review أو - [x] Draft. احتفظ بالمسافة داخل القوسين الفارغين. مربعات الاختيار جزء من GitHub Flavored Markdown، وفي مسائل GitHub وطلبات السحب يمكنك تأشيرها بنقرة.
كيف أغيّر حجم صورة في Markdown؟
لا توجد في Markdown العادية صيغة للحجم: ![alt text](image.png) تعرض الصورة دائمًا بحجمها الأصلي. استخدم وسم 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؟
ملف نصي عادي مكتوب بـMarkdown. الامتدادان المعتادان هما .md و.markdown، وREADME.md هو الملف الذي يعرضه GitHub في الصفحة الرئيسية للمستودع. يفتحه أي محرر نصوص، ويعرضه GitHub ومواقع التوثيق وعارضات Markdown كنص منسّق. لترى الملف معروضًا أثناء تعديله، الصقه في محرر Markdown.
Coddy programming languages illustration

تعلّم Markdown مع Coddy

ابدأ الآن