القوسان الزاويان يحوّلان عنوان البريد الإلكتروني إلى رابط بريد.

صورة. تُكتب كالرابط مع علامة تعجب في أوله؛ ويصف النص الذي بين القوسين المعقوفين الصورة.
`inline code`
شيفرة داخل جملة، محاطة بعلامات الاقتباس العكسية (backtick).
`` code with a ` backtick ``
استخدم علامتي اقتباس عكسيتين متتاليتين عندما تحتوي الشيفرة نفسها على علامة اقتباس عكسية.
```
code block
```
كتلة شيفرة بين سطرين يحتوي كل منهما على ثلاث علامات اقتباس عكسية. ويبقى النص داخلها كما كُتب.
```js
console.log("Hi");
```
أضف اسم اللغة بعد علامات الاقتباس العكسية الافتتاحية لتتمكن المحررات من تلوين الشيفرة.
> Quoted text
نص مقتبس. ابدأ السطر بعلامة «أكبر من».
> Quoted text
>> Nested quote
أضف علامة «أكبر من» أخرى لاقتباس داخل اقتباس.
---
خط فاصل. ضع ثلاث شرطات أو علامات نجمة أو شرطات سفلية أو أكثر في سطر مستقل.
| Name | Qty |
| --- | --- |
| Apple | 3 |
| Pear | 5 |
جدول. افصل الأعمدة بخطوط عمودية وضع صفاً من الشرطات تحت صف العناوين.
| Left | Center | Right |
| :--- | :---: | ---: |
| a | b | c |
النقطتان الرأسيتان في الصف الفاصل تحاذيان العمود إلى اليسار أو الوسط أو اليمين.
ما هي Markdown
لغة Markdown طريقة لكتابة مستندات منسّقة بنص عادي. فبضعة رموز تُكتب حول الكلمات العادية تحدد العناوين والتوكيد والقوائم والروابط والشيفرة، ويبقى النص مقروءاً حتى قبل تحويله.
تُستخدم في ملفات README والتوثيق وتطبيقات تدوين الملاحظات ورسائل المحادثة وكثير من أدوات التدوين. ويعرض المحرر أعلاه كيف يظهر كل عنصر من عناصر الصياغة أثناء الكتابة.
نصائح لكتابة Markdown نظيفة
تنشأ معظم المشكلات من المسافات لا من الرموز نفسها.
ضع مسافة بعد علامات # في العنوان وبعد علامة عنصر القائمة.
اترك سطراً فارغاً قبل العناوين والقوائم والاقتباسات وكتل الشيفرة وبعدها.
أزِح عناصر القائمة المتداخلة لتصطف مع نص العنصر الذي فوقها.
ضع شرطة مائلة عكسية قبل رمز مثل * أو _ ليظهر كما هو.
الأسئلة الشائعة
هل تبدو Markdown متطابقة في كل مكان؟+
الأساسيات نعم. فالعناوين والتوكيد والقوائم والروابط والشيفرة تتبع معيار CommonMark في كل مكان تقريباً. أما الجداول وقوائم المهام والنص المشطوب فهي امتدادات شاعت بفضل GitHub، لذا لا تدعمها بعض التطبيقات.
لماذا لا تشغّل المعاينة شيفرة HTML ولا تحمّل صوري؟+
المعاينة محدودة عن قصد. تُعرض شيفرة HTML الخام كنص، وتظهر الصور كعناصر نائبة تحمل وصفها بدلاً من تنزيلها، ولا يمكن النقر إلا على روابط http وhttps وmailto.
هل يُرسل النص الذي أكتبه إلى أي مكان؟+
لا. تُنشأ المعاينة داخل متصفحك، ولا يُرفع النص ولا يُحفظ.