شرح Markdown: النسخة المختصرة
يستخدم Markdown بعض الرموز لتنسيق النص. كذلك، لإنشاء عنوان، استخدم #. ولإنشاء نص عريض استخدم **. ولإنشاء قائمة استخدم -. جمعت هنا هذه الرموز مع كود HTML الناتج عن كل منها.
يمكنك تجربة كل سطر في محوّل Markdown إلى HTML المجاني لدينا. أيضًا، اكتب Markdown في جهة، وشاهد HTML والمعاينة يتغيران أمامك.
يدعم GitHub وGitLab وReddit وDiscord وNotion وObsidian وSlack وغيرها من التطبيقات الموفرة لحركة الشعر أو الأصابع Markdown. كذلك، يتم شرح تفاصيل كل تنويع هنا عند الحاجة.
أساسيات Markdown
عرّف John Gruber هذه الرموز لأول مرة، وتدعمها جميع تطبيقات Markdown. أيضًا، إن حفظ هذا الجدول على جهازك سيسمح لك بتنسيق أي نص وفقًا لهذه القواعد بدقة.
| تكتب | تحصل على | HTML |
|---|---|---|
| # عنوان 1 | أكبر عنوان | <h1> |
| ## عنوان 2 | عنوان قسم | <h2> |
| ### عنوان 3 | عنوان أصغر | <h3> |
| **عريض** | عريض | <strong> |
| *مائل* | مائل | <em> |
| ***كلاهما*** | كلاهما | <strong><em> |
| `كود` | كود | <code> |
| مسافتان في آخر السطر | سطر جديد | <br> |
| سطر فارغ | فقرة جديدة | <p> |
تبدأ العناوين من علامة # واحدة حتى ست علامات. ضع دائمًا مسافة بعدها، لأن تطبيقات كثيرة تتجاهل #عنوان دون مسافة. وتعمل الشرطة السفلية أيضًا للخط العريض والمائل، لكن النجوم أكثر أمانًا داخل الكلمات.
القوائم والاقتباسات والخطوط
في القوائم توفّر Markdown أكبر قدر من الوقت، وفأنت تكتبها كما تكتبها في رسالة بريد عادية.
- First item
- Second item
- Indented item
1. Step one
2. Step two
3. Step three
> A quote stays indented.
--- تبدأ القوائم النقطية بواصلة أو علامة نجمية أو علامة زائد. كذلك، وتبدأ القوائم المرقمة بأرقام مسبوقة بنقطة. لإنشاء قائمة فرعية، أضف مسافتين أو أربع مسافات إلى عنصر القائمة السابق.
تبدأ الاقتباسات المحظورة بعلامة أكبر من. أيضًا، تُرسم الخطوط الأفقية باستخدام ثلاث واصلات ممتدة عبر سطر مستقل.
الروابط والصور
لتضمين صورة في منشور، ضمّن عنوان URL الخاص بها ضمن زوج من الأقواس، تمامًا كما في رابط ويب. كذلك، ولتضمين صورة مضمنة، استخدم علامة تعجب قبل الأقواس.
| تكتب | النتيجة |
|---|---|
| [Denwix](https://denwix.com) | رابط بنص Denwix |
| [Denwix](https://denwix.com "Tools") | رابط مع عنوان يظهر عند التمرير |
| <https://denwix.com> | عنوان قابل للنقر |
|  | صورة بنص بديل Logo |
| [](https://denwix.com) | صورة تعمل كرابط أيضًا |
يقرأ قارئو الشاشة النص المحاط بالأقواس في منشور الصورة، وتستخدمه محركات البحث للتعرف على الصورة. أيضًا، صفها بإيجاز ودقة قدر الإمكان.
الكود في Markdown
لتضمين جزء صغير من الشيفرة في منشور، استخدم العلامات الخلفية على جانبيه. كذلك، ولتضمين شيفرة على عدة أسطر، استخدم ثلاث علامات خلفية لإحاطة الشيفرة.
```javascript
const total = items.reduce((sum, n) => sum + n, 0);
console.log(total);
``` يمكن إضافة اسم لغة البرمجة التي سيُعرض الكود بها مع تمييز الصياغة بعد العلامات الخلفية. وإذا احتوى الكود نفسه على علامات خلفية، فاستخدم ثماني علامات خلفية بدلًا من ذلك.
إضافات GitHub على Markdown
يتيح تطبيق GitHub لـ Markdown توسيع الصياغة الأساسية. أيضًا، تُطبَّق هذه الإضافات في واجهات برمجية متنوعة، ومن المرجح أن تختلف من بيئة برمجية إلى أخرى.
| الميزة | تكتب | ملاحظة |
|---|---|---|
| جدول | | Name | Price | | سطر ثانٍ من الشرطات مثل |---|---| يحدد رأس الجدول |
| قائمة مهام | - [ ] To do / - [x] Done | تظهر مربعات اختيار في GitHub |
| نص مشطوب | ~~old price~~ | يرسم خطًا فوق النص |
| رابط تلقائي | https://denwix.com | تتحول العناوين إلى روابط |
| حاشية | Text[^1] and [^1]: Note | مدعومة في GitHub منذ 2021 |
الجداول هي الإضافة الأكثر استخدامًا، وكل صف في سطر، والخطوط العمودية تفصل الخلايا، والنقطتان في سطر الشرطات تحددان المحاذاة. كذلك، وتشرح مواصفة GitHub Flavored Markdown كل قاعدة بالتفصيل.
جرّب كل رمز مباشرة
لن تكون قراءة دليل Markdown مفيدة جدًا ما لم تكتب الرموز وتستخدمها بنفسك. أيضًا، ولحسن الحظ، يمنحك محوّلنا ملاحظات فورية.
افتح محوّل Markdown إلى HTML واضغط جرّب مثالًا، ويحمّل عناوين وقوائم ورابطًا وجدولًا، ويظهر HTML بجانب Markdown.

وفي الأسفل تعرض المعاينة الصفحة النهائية، وفعّل إضافات GitHub لترى الجداول والمهام والنص المشطوب، ثم انسخ HTML النظيف إلى موقعك.

حالة حقيقية: ملف README الذي لم يقرأه أحد
كان مشروع صغير مفتوح المصدر يتلقى الأسئلة نفسها دائمًا على GitHub. وكانت الأجوبة موجودة في ملف README، لكن الملف كان كتلة نص طويلة بلا عناوين ولا قوائم.
خصص المسؤول عن المشروع عشرين دقيقة لإضافة Markdown، وفصارت خطوات التثبيت قائمة مرقمة، والأوامر كتل كود، والخيارات جدولًا. كما أظهرت قائمة مهام في النهاية ما سيأتي لاحقًا.
خلال شهر واحد قلّت الأسئلة المكررة إلى أقل من النصف، واختار مساهمان جديدان مهام من القائمة مباشرة.
| قبل | بعد | رموز Markdown |
|---|---|---|
| كتلة نص واحدة | خمسة أقسام واضحة | ## عناوين |
| خطوات داخل جملة | قائمة مرقمة | 1. 2. 3. |
| أوامر كنص عادي | كتل كود قابلة للنسخ | كتل ``` |
| خيارات موصوفة بالكلام | جدول خيارات | | خطوط | |
أخطاء شائعة وحلولها
تحدث غالبية أخطاء Markdown بسبب إهمال بضع نقاط. كذلك، راجع ما يلي عندما لا يبدو مستندك صحيحًا.
- لا مسافة بعد علامة #: اكتب
# عنوانوليس#عنوان. - لا سطر فارغ قبل القائمة: تعامل تطبيقات كثيرة القائمة كجزء من الفقرة.
- خلط علامات الجدولة بالمسافات: تنكسر القوائم المتداخلة، لذلك استخدم المسافات فقط.
- جدول بلا سطر شرطات: تظهر الصفوف كنص عادي مع خطوط.
- علامات كود غير مغلقة: يتحول باقي الصفحة إلى كود.
باختصار: تعلّم الجدول الأساسي، وأضف إضافات GitHub حيث يدعمها تطبيقك، وجرّب كل جديد في معاينة قبل النشر.
أسئلة وأجوبة
ما هي Markdown؟
إنها لغة شبيهة بـ HTML لتنسيق النص باستخدام أحرف مثل # و.
كيف أكتب عنوانًا في Markdown؟
لإنشاء عنوان بأكبر حجم للخط، استخدم علامة # واحدة مثل هذا: # عنوان.
كيف أجعل النص عريضًا؟
للدلالة على وجوب عرض النص بخط عريض، استخدم نص.
كيف أجعل النص مائلًا؟
ضعه بين نجمة واحدة من كل جهة، مثل *مائل*. وتعمل الشرطة السفلية أيضًا.
كيف أضيف رابطًا؟
اكتب النص بين أقواس مربعة والعنوان بين أقواس دائرية، مثل [Denwix](https://denwix.com).
كيف أضيف صورة؟
استخدم شكل الرابط مع علامة تعجب قبله، مثل .
كيف أصنع قائمة نقطية؟
ابدأ كل سطر بشرطة أو نجمة أو علامة جمع ثم مسافة. أيضًا، وأضف مسافتين أو أربعًا للقوائم المتداخلة.
كيف أصنع قائمة مرقمة؟
ابدأ كل سطر برقم ونقطة. كذلك، ولا يلزم أن تكون الأرقام بالترتيب.
كيف أصنع جدولًا في Markdown؟
استخدم الشرطة لإنشاء خط تحت رأس جدولك. أيضًا، أضف خطوطًا عمودية لفصل خلايا الجدول.
كيف أضيف كتلة كود؟
قبل الكود وبعده اكتب ~~~~ وضمن ~~~ اكتب اسم لغة البرمجة.
كيف أبدأ سطرًا جديدًا؟
لإنشاء فقرة جديدة، اترك سطرًا فارغًا.
كيف أشطب نصًا؟
لإحاطة النص بقواعد أفقية استخدم ~ على جانبي النص، مثل هذا.
كيف أضيف مربع اختيار؟
استخدم - [ ] لعلامة غير محددة، و - [x] لعلامة محددة.
كيف أكتب تعليقًا في Markdown؟
استخدم تعليق HTML مثل <!-- note -->، ولا يظهر في الصفحة النهائية.
هل تدعم Markdown الخط المسطر؟
ليس في Markdown القياسية، وبعض التطبيقات تقبل وسم HTML <u> بدلًا منه.
هل Markdown واحدة في GitHub وDiscord؟
الأساسيات واحدة، أما الإضافات مثل الجداول والحواشي فتختلف من تطبيق إلى آخر.
ما امتداد ملفات Markdown؟
غالبًا ما تكون لها الامتداد .md أو .markdown. كذلك، المثال الأكثر شيوعًا على ذلك هو ملف README.md.
هل أستطيع كتابة HTML داخل Markdown؟
نعم. أيضًا، يزيل GitHub ومواقع أخرى الوسوم التي قد تكون ضارة.
كيف أحوّل Markdown إلى HTML؟
الصقه في محوّل Markdown إلى HTML لدينا وانسخ HTML النظيف. يعمل داخل متصفحك.
هل المحوّل مجاني؟
إنه مجاني ولا يتعين عليك إنشاء حساب. يتم تخزين نصك بشكل آمن في متصفحك.