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

اختر ما تسمح به
+92 312 8299940عرض سعر مجاني
AR – اللغة: العربية
Blog

شرح Markdown كل رمز مع مثال

شرح Markdown بكل رموزه في جدول واحد: العناوين والخط العريض والقوائم والروابط والصور والكود والجداول والمهام، مع HTML لكل رمز.

بقلم Daniyal Subhani 6 min read

شرح Markdown: النسخة المختصرة

يستخدم Markdown بعض الرموز لتنسيق النص. كذلك، لإنشاء عنوان، استخدم #. ولإنشاء نص عريض استخدم **. ولإنشاء قائمة استخدم -. جمعت هنا هذه الرموز مع كود HTML الناتج عن كل منها.

رسم لرموز Markdown الأساسية: علامة # للعناوين والنجوم للخط العريض والمائل والشرطات والأقواس للقوائم والروابط
ثلاث مجموعات تغطي أغلب ما تكتبه يوميًا.

يمكنك تجربة كل سطر في محوّل Markdown إلى HTML المجاني لدينا. أيضًا، اكتب Markdown في جهة، وشاهد HTML والمعاينة يتغيران أمامك.

يدعم GitHub وGitLab وReddit وDiscord وNotion وObsidian وSlack وغيرها من التطبيقات الموفرة لحركة الشعر أو الأصابع Markdown. كذلك، يتم شرح تفاصيل كل تنويع هنا عند الحاجة.

أساسيات Markdown

عرّف John Gruber هذه الرموز لأول مرة، وتدعمها جميع تطبيقات Markdown. أيضًا، إن حفظ هذا الجدول على جهازك سيسمح لك بتنسيق أي نص وفقًا لهذه القواعد بدقة.

رموز 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.

---

تبدأ القوائم النقطية بواصلة أو علامة نجمية أو علامة زائد. كذلك، وتبدأ القوائم المرقمة بأرقام مسبوقة بنقطة. لإنشاء قائمة فرعية، أضف مسافتين أو أربع مسافات إلى عنصر القائمة السابق.

تبدأ الاقتباسات المحظورة بعلامة أكبر من. أيضًا، تُرسم الخطوط الأفقية باستخدام ثلاث واصلات ممتدة عبر سطر مستقل.

الكود في Markdown

لتضمين جزء صغير من الشيفرة في منشور، استخدم العلامات الخلفية على جانبيه. كذلك، ولتضمين شيفرة على عدة أسطر، استخدم ثلاث علامات خلفية لإحاطة الشيفرة.

```javascript
const total = items.reduce((sum, n) => sum + n, 0);
console.log(total);
```

يمكن إضافة اسم لغة البرمجة التي سيُعرض الكود بها مع تمييز الصياغة بعد العلامات الخلفية. وإذا احتوى الكود نفسه على علامات خلفية، فاستخدم ثماني علامات خلفية بدلًا من ذلك.

إضافات GitHub على Markdown

يتيح تطبيق GitHub لـ Markdown توسيع الصياغة الأساسية. أيضًا، تُطبَّق هذه الإضافات في واجهات برمجية متنوعة، ومن المرجح أن تختلف من بيئة برمجية إلى أخرى.

إضافات GitHub
الميزةتكتبملاحظة
جدول| 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.

محوّل Markdown إلى HTML مع Markdown على اليسار وHTML الناتج على اليمين
يوجد كود HTML الخاص بكل مثال على يمين كل مثال.

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

معاينة Markdown المحوّل مع عنوان وقائمة ورابط وجدول
تعرض المعاينة الصفحة كما ستظهر.

حالة حقيقية: ملف README الذي لم يقرأه أحد

كان مشروع صغير مفتوح المصدر يتلقى الأسئلة نفسها دائمًا على GitHub. وكانت الأجوبة موجودة في ملف README، لكن الملف كان كتلة نص طويلة بلا عناوين ولا قوائم.

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

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

ما الذي تغيّر في README
قبلبعدرموز Markdown
كتلة نص واحدةخمسة أقسام واضحة## عناوين
خطوات داخل جملةقائمة مرقمة1. 2. 3.
أوامر كنص عاديكتل كود قابلة للنسخكتل ```
خيارات موصوفة بالكلامجدول خيارات| خطوط |

أخطاء شائعة وحلولها

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

  • لا مسافة بعد علامة #: اكتب # عنوان وليس #عنوان.
  • لا سطر فارغ قبل القائمة: تعامل تطبيقات كثيرة القائمة كجزء من الفقرة.
  • خلط علامات الجدولة بالمسافات: تنكسر القوائم المتداخلة، لذلك استخدم المسافات فقط.
  • جدول بلا سطر شرطات: تظهر الصفوف كنص عادي مع خطوط.
  • علامات كود غير مغلقة: يتحول باقي الصفحة إلى كود.

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

أسئلة وأجوبة

ما هي Markdown؟

إنها لغة شبيهة بـ HTML لتنسيق النص باستخدام أحرف مثل # و.

كيف أكتب عنوانًا في Markdown؟

لإنشاء عنوان بأكبر حجم للخط، استخدم علامة # واحدة مثل هذا: # عنوان.

كيف أجعل النص عريضًا؟

للدلالة على وجوب عرض النص بخط عريض، استخدم نص.

كيف أجعل النص مائلًا؟

ضعه بين نجمة واحدة من كل جهة، مثل *مائل*. وتعمل الشرطة السفلية أيضًا.

كيف أضيف رابطًا؟

اكتب النص بين أقواس مربعة والعنوان بين أقواس دائرية، مثل [Denwix](https://denwix.com).

كيف أضيف صورة؟

استخدم شكل الرابط مع علامة تعجب قبله، مثل ![Alt](image.png).

كيف أصنع قائمة نقطية؟

ابدأ كل سطر بشرطة أو نجمة أو علامة جمع ثم مسافة. أيضًا، وأضف مسافتين أو أربعًا للقوائم المتداخلة.

كيف أصنع قائمة مرقمة؟

ابدأ كل سطر برقم ونقطة. كذلك، ولا يلزم أن تكون الأرقام بالترتيب.

كيف أصنع جدولًا في 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 النظيف. يعمل داخل متصفحك.

هل المحوّل مجاني؟

إنه مجاني ولا يتعين عليك إنشاء حساب. يتم تخزين نصك بشكل آمن في متصفحك.

دليل بالفيديو

تجربة كل رمز في Markdown مباشرة

في هذا الفيديو القصير تمرّ الأداة أمامك من أول خطوة إلى آخرها. اختر لغتك من القائمة بالأسفل، وفعّل الترجمة النصية إذا كانت تساعدك.

جرّب Markdown الآن

يتيح لك كتابة Markdown، وعرض HTML الذي ينتجه، ونسخ HTML إلى موقعك.

فضّل Denwix على Googleقيّم Denwix على Google