Tag: ماركداون

المقدمة

نبدأ بتعريف الماركداون من ويكيبيديا

ماركداون (بالإنجليزية: MarkDown) هي رموز للتنسيق تعتمد على لغة ترميز بسيطة، تسمح بكتابة محتوى نصي بسيط يتميز بسهولة الكتابة والقراءة، ثم تحويله إلى لغة HTML أو XHTML.

بعبارة أخرى، لغة بسيطة جدا لتنصيق النص بدون كتابة HTML بقواعدها المعقدة بعض الشيء مقارنة بماركداون.

ويمكنك تنصيق النص بعدة منصات مثلا تلغرام، يونغرام ، بلايروم, Github, ووردبرس، مواقع البريد الالكتروني مثل جيميل ومنصات أخرى عديدة.

والمتصفحات تقوم بعرض النص كما لو مكتوب بلغة HTML.

أحاول هنا شرح تقريبا كل الرموز المستخدمة للكتابة بطريقة ماركداون مع الأمثلة.

إنشاء الرأسيات

لإنشاء الرأسيات ما عليك سوا وضع علامة الرقم # قبل عنوان الرأسية وتضعها حسب المستوى مثلا للمستوى لااثني تضعها مرتين

مثال:

## هذه رأسية 2

### هذه رأسية 3

الناتج:

هذه رأسية 2

هذه رأسية 3

يفضل وضع مسافة بعد علامة الرقم وترك سطر فارغ قبل الرأسية وبعدها مباشرة.

الفقرات

لبدأ فقرة جديدة أو سطر جديد، اترك سطرا فارغا بين الفقرتين أو الجملتين أو أي شيء تريد الفصل بينهما.

يفضل عدم وضع مسافة في بداية الفقرة، فقط اترك سطر وابدأ بالكتابة.

الخط العريض والمائل

لكتابة جملة أو كلمة بالخط العريض (Bold) ضعها بين نجمتين

مثال:

**هذه الجملة بالخط العريض**

الناتج:

هذه الجملة بالخط العريض

ونجمة وحدةة للخط المائل Italic.

مثال:

هذه *الكلمة* بالخط المائل

الناتج:

هذه الكلمة بالخط المائل

لجعل التأثيرين معا، العريض والمائل، استخدم ثلاث نجمات.

وضع الاقتباس

لإشارة إلى أن النص مقتبس أو جملة، يمكن وضع علامة أكبر من ‘>" قبل الجملة أو الفقرة.

مثال:

> هذه الفقرة مقتبسة من ويكيبيديا

الناتج:

هذه الفقرة مقتبسة من ويكيبيديا

ويمكن وضع علامة أكبر من مرتين لو أردت اقتباس داخل اقتباس ثاني.

يفضل ترك سطر فارغ قبل وبعد الفقرة المقتبسة أو السطر.

القوائم

هناك نوعين من القوائم في html فبالتالي في ماركداون، القوائم المرتبة والغير المرتبة.

المرتبة تكون بداية كل عنصر رقم أو حرف، بينما الغير مرتبة رمز ال • قبل كل عنصر.

القوائم الغير مرتبة

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

ملاحظة، السطر الفارغ فقط قبل وبعد القائمة وليس بين العناصر.

مثال:

– العنصر الأول

– العنصر الثاني

– العنصر الثالث

الناتج:

• العنصر الأول
• العنصر الثاني
• العنصر الثالث

القوائم المرتبة

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

وكذلك ترك سطر فارغ بعد وقبل القائمة، وليس بين كل عنصر.

سأضع عدة أمثلة حتى تتضح الصورة.

مثال بالأرقام:

1. العنصر الأول

2. العنصر الثاني

3. العنصر الثالث

الناتج:

1. العنصر الأول
2. العنصر الثاني
3. العنصر الثالث

مثال بدون تلسل الأرقام:

1. العنصر الأول

1. العنصر الثاني

8. العنصر الثالث

الناتج:

1. العنصر الأول
2. العنصر الثاني
3. العنصر الثالث

ملاحظة: بعض المنصات تسمح بعمل القائمة باستخدام الأحرف الكبيرة Capital letters ولكن أماكن أخرى لا تدعمها.

القوائم المتداخلة

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

مثال:

1. العنصر الأول

1. العنصر الثاني

- العنصر الفرعي الأول
- العنصر الفرعي الثاني

1. العنصر الثالث

الناتج:

1. العنصر الأول
2. العنصر الثاني
   • العنصر الفرعي الأول
   • العنصر الفرعي الثاني
3. العنصر الثالث

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

عند كتابة الشفرات البرمجية، لو سطر كتابتها بين علامة `

مثال:

اكتب `cd` في نافذة الأوامر لتغير المسار

الناتج:

اكتب cd في نافذة الأوامر لتغير المسار

أما لو مجموعة أسطر، فنبدأ بسطر منفصل ` ثلاث مرات ونضع نفسها في النهاية كما في المثال.

مثال:

“`

niceMessage = input("enter a nice message")

print(niceMessage)

“`

الناتج:

niceMessage = input("enter a nice message")
print(niceMessage)

مستخدمي قارئات الشاشة لا يشعرون بالفرق، لكن شكليا فهناك فرق، وفي منتديات البرمجة ينبهونك لو ما استخدمتها وشاركت بكود برمجي.

فاصل أفقي

لوضع خط فاصل أفقي ضع ثلاث أو أكثر من علامة النجمة "*"، أو شرطة "-" أو شرطة على السطر "_".

مثال:

——-

***

____

الناتج لأي مما سبق هو واحد:

---

الروابط

عادة في ماركداون صيغة الروابط تتحول إلى روابط مباشرة ولكن يمكن وضع الرابط بين علامتين أصغر من "<" وأكبر من ">" للتأكيد.

مثال:

<https://www.fawazar.me/>

الناتج:

https://fawaz.me/

تسمية الروابط

لو أردت تسمية الرابط مثلا موقع فواز عبد الرحمن بدلا من وضع الرابط مباشرة مثل https://www.fawazar.me/

يمكنك استخدام الصيغة الآتية:

[الاسم](الرابط)

مثال:

[موقع جوجل](https://www.google.com/)

الناتج:

موقع جوجل

تسمية الروابط في المراجع

هناك طريقة أخرى أيضا لتسمية الروابط لو الرابط ضمن فقرة معينة، تسهل القراءة شكليا.

الرابط ينقسم إلى قسمين، في الفقرة نكتب مثلا [اسم الرابط][الرمز]

ثم أي مكان في الملف مثلا بعد الفقرة أو في نهاية الملف نكتب

[الرمز]: <الرابط>

مثال:

هنا نجرب وضع وصلة [لموقع آبل][1]

[1]: <https://www.apple.com>

الناتج:

هنا نجرب وضع وصلة لموقع آبل

وضع عنوان للرابط

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

الصيغة كالآتي:

[الاسم](الرابط "العبارة")

الصور

الصور مثل الروابط تماما، فقط نزيد علامة التعجب في البداية ومكان الاسم نكتب الوصف البديل لمستخدمي قارآت الشاشة.

مثال:


الناتج:

وضع الرابط في الصورة

يمكن وضع الصورة مكان اسم الرابط لجعل الصورة تنقلك إلى الرابط

الصيغة:

[](الرابط)

مثال:

[](https://www.apple.com)

الناتج:

تخطي الرموز

لكتابة الرمز المستخدم في ماركداون كما هي، ضع علامة "" قبل الرمز حتى لا يتم احتساب ضمن الماركداون.

مثلا لو أردت كتابة نجمة اكتبها "*".

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

خصائص إضافية في بعض المحررات

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

علما أن هذه الخصائص ليست مدعومة كل مكان، فيجب التأكد قبل الاستخدام.

طريقة إنشاء الجدول

مثلا لو ننشأ جدول مع أسماء اللاعبين ونقاطهم:

| الاسم | النقاط |

| — | — |

| فواز | 1000 |

| مارينا | 1000 |

| قيس | 1000 |

الناتج:

الاسم	النقاط
فواز	1000
مارينا	1000
قيس	1000

وضع معرف

يمكن وضع معرف بعد الرأسية بين قوسين مع علامة الرقم كالآتي:

### رأسية مستوى 3 {#المعرف}

طريقة إنشاء ملفات ماركداون

هناك محررات تلقائية تدعم ماركداون مثل github وتلغرام وفي ووردبرس مثلا لا بد من وضع Block لماركداون، يمكن تفعيلها بتثبيت إضافة jetpack الشهيرة أو باستخدام المحرر الكلاسيكي.

أما في الكمبيوتر، يمكن إنشاء ملف بأي محرر بصيغة .md ولكن لا تعطيك خاصية المعاينة هذه المحررات إلا بعضها.

شخصيا أستخدم Visual Studio Code هو برنامج ضخم ولكن كل ما يهم لكتابة ماركداون ما يلي

• Control+n لإنشاء ملف جديد
• control+s لحفظ الملف ويجب تسميته مع الصيغة .md مثلا تجربة.md
• يجب حفظ الملف قبل الكتابة حتى يتعرف البرنامج أنك تكتب ماركداون.
• control+shift+v للمعاينة في تبويبة جديدة، ويمكن قفل التبويبة ب control+w.
• اضغط اختصار الحفظ بين حين وآخر للحفظ بشكل مستمر.
• محرر vs code يستخدم للكثير من الأشياء، فهو ربما خيار ضخم فقط لماركداون لكنه خفيف وسريع.

الختام

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

أي محررات أخرى لكتابة الماركداون شاركوها وسأضعها بإذن الله في الموضوع، وأي استفسار أنا بالخدمة.

تحياتي.