شرح لغة Markdown بإختصار

لغة Markdown هى لغة بسيطة وجميلة لكتابة الصفحات وتحديد عناصر الصفحات. وهى عبارة عن Markup Language وتشبه لغة html فى هدفها حيث تحدد بها عناصر الصفحة ومكوناتها. والآن فلنبدأ فى معرفة كيف تكتب أجزاء الكلام بلغة Markdown.

كيف أكتب العناوين Headers فى لغة Markdown؟ 🔗

يمكنك كتابة العنوان الأساسى فى الصفحات (header 1) عن طريق وضع رمز الشباك قبل العنوان كالتالى:

# Header One

ويمكنك كتابة باقى العناوين كالتالى:

## Header 2

### Header 3

#### Header 4

##### Header 5

###### Header 6

ويمكنك أيضاً أن تكتب عنوان وتحته خط بالطريقة التالية:

Alt-H1
======

أو بهذه الطريقة:

Alt-H2
------

كيف أكتب الكلمات المائلة italic فى لغة Markdown ؟ 🔗

هناك طريقتين لكتابة النصوص المائلة فى لغة مارك داون وهما إما بإستخدام الشرطة السُفلية (underscore) أو النجمة الواحدة (single asterisk) كما يلى:

*asterisks* or _underscores_

كيف أكتب النص سميك bold فى لغة مارك داون؟ 🔗

يمكنك استخدام إما شرطتين سفليتين أو نجمتين متتاليتين كما سترى هنا:

**asterisks** or __underscores__

كيف تكتب كلمات مشطوبة Strike through بلغة Markdown؟ 🔗

يمكنك كتابة الكلمات المشطوبة عن طريق علامة التقريب أو الشرطة المموجة (~) كما ترى فى المثال التالى:

~~Strike Through Text~~

كيف أكتب قائمة مرقمة Ordered List فى لغة Markdown؟ 🔗

يمكنك كتابة قائمة مرقمة عن طريق كتابة الترقيم قبل كل سطر بشكل عادى مثل:

1. first item in the ordered list
2. second item in this ordered list
3. third ..

كيف أكتب قائمة غير مرقمة Unordered List فى لغة Markdown؟ 🔗

يمكنك استخدام رمز النجمة (*)، أو الناقص (-)، أو الزائد (+) لعمل قائمة غير مرقمة كما ترى فى المثال التالى:

* Unordered list can use asterisks

- Or minuses

+ Or pluses

كيف أضيف رابط إلى الصفحات المكتوبة بلغة Markdown؟ 🔗

يمكنك كتابة رابط به الكلمة والمسار فقط:

[I'm an inline-style link](https://www.google.com)

ويمكنك أيضاً كتابة رابط به الكلمة والمسار وعنوان للرابط، عندما يمرر المستخدم الماوس على الرابط يرى العنوان الذى يخبره بمحتوى مسار الرابط:

[I'm an inline-style link with title](https://www.google.com "Google's Homepage")

كتابة رابط به مسار نسبى وليس مسار كامل:

[I'm a relative reference to a repository file](../blog/master/LICENSE)

كتابة رابط كمرجع داخل نفس الصفحة:

[You can use numbers for reference-style link definitions][1]

ويمكنك أن تُنشئ رابط داخلى (مرجع) بالنص نفسه بدون أرقام: Or leave it empty and use the [link text itself].

ويمكنك انشاء رابط عن طريق نص الرابط وجملة يتم تفسيرها إلى رابط فى أسفل صفحة الـ Markdown:

[I'm a reference-style link][Arbitrary case-insensitive reference text]

وهنا تجد تفسيرات الكلمات والأرقام الموجودة كمرجع لمسار معين:

[arbitrary case-insensitive reference text]: <https://www.mozilla.org>
[1]: <http://slashdot.org>
[link text itself]: <http://www.reddit.com>

كيف أضيف صورة فى صفحة Markdown ؟ 🔗

هناك طريقة لإضافة صورة مباشرةً: Inline-style: ![alt text](https://1.bp.blogspot.com/-BHr003pOqqw/WnTpCQW1HiI/AAAAAAAAc6U/lwgUacelpRIKpUg6_5P5L0xajQSoKsQ6ACK4BGAYYCw/s1600/tech-blue-logo.png "Logo Title Text 1")

أو إضافة صورة من خلال مراجع تُكتب فى أسفل وثيقة الـ Markdown كما يلى: Reference-style: ![alt text][logo] [logo]: https://1.bp.blogspot.com/-BHr003pOqqw/WnTpCQW1HiI/AAAAAAAAc6U/lwgUacelpRIKpUg6_5P5L0xajQSoKsQ6ACK4BGAYYCw/s1600/tech-blue-logo.png "Logo Title Text 2"

كيف أكتب الأكواد والسكربتات داخل صفحة Markdown ؟ 🔗

يمكنك ادراج الأكواد عن طريق الشرطة المفردة الموجودة فى زر حرف الذال (ذ) عندما تكون لوحة المفاتيح تكتب إنجليزى. واستخدامه يكون كما يلى:

this is code as you can distinguish it from other words.

يمكنك أيضاً كتابة بلوكات من الكود أو السكربت عن طريق كتابة أسطر الكود بين سطرين من الشُرط كما ترى فى الأمثلة التالية:

var s = "JavaScript syntax highlighting";
alert(s);

s = "Python syntax highlighting"
print s

No language indicated, so no syntax highlighting. 
But let's throw in a <b>tag</b>.

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

كيف أنشئ جدول بلغة Markdown؟ 🔗

يمكنك إنشاء جدول بهذه الطريقة المنسقة الرائعة:

أو يمكنك استخدم ثلاث شرط كحد أدنى لعدد الشرط فى السطر الثانى، كما ترى فى الكود التالى:

كيف أضيف نص اقتباس blockquote بلغة Markdown ؟ 🔗

يمكنك اضافة نص اقتباس عن طريق علامة أكبر من (<) كما ترى فى الكود التالى:

> Blockquotes are very handy in email to emulate reply text.
> This line is part of the same quote.

لاحظ أن السطر الثانى تابع لنفس النص المقتبس.

> This is a very long line that will still be quoted properly when it wraps. Oh boy let's keep writing to make sure this is long enough to actually wrap for everyone. Oh, you can *put* **Markdown** into a blockquote.

أما فى الطريقة السابقة فقد كتبت سطر واحد طويل جداً كنص اقتباس، ولكن سيقوم عرض Markdown وبعمل فقرة اقتباس بشكل جميل فى عدّة أسطر (كما سترى فى الفيديو).

هل يمكننى أن أكتب بلغة HTML فى صفحة الـ Markdown ؟ 🔗

نعم، وسوم html ستعمل بشكل جيد كما ترى فى المثال التالى:

<dl>
  <dt>Definition list</dt>
  <dd>Is something people use sometimes.</dd>
  <dt>Markdown in HTML</dt>
  <dd>Does *not* work **very** well. Use HTML <em>tags</em>.</dd>
</dl>

انشاء سطر عرضى فى الصفحة 🔗

يمكنك إنشاء سطر عرضى فى الصفحة عن طريق ثلاث شرط وسطية (---) أو ثلاث شرط سفلية (___) أو ثلاث نجوم (***) كما ترى فى المثال التالى

---
Hyphens
***
Asterisks
___
Underscores

أتمنى أن تكون قد استفدت اليوم من الموضوع. أراك فى موضوعات أخرى على الموقع إن شاء الله.

اقرأ أيضاً:

• أفضل برنامج لكتابة الرسائل العلمية والمعادلات
• أسهل طريقة لكتابة المعادلات العلمية