بسم الله الرحمن الرحيم
اليوم الدرس الثاني من سلسلة برنامج أبسيديان، نتعلم فيه لغة التنسيق التي سنكتب بها في البرنامج، ألا وهي لغة التنسيق MarkDown، ولا يروعك لفظ (لغة) فهي سهلة يسيرة نستعملها في برنامج أوبسيديان حتى ننسق ما نكتبه دون عناء أو مشقة.

ما لغة MarkDown

إنها لغة تنسيق نصوص أنشأها جون جروبر عام ٢٠٠٤م، وهذه اللغة تغاير البرامج المعروفة، مثل Microsoft Word التي تتبع نهج “ما تراه هو ما ستناله، اختصارًا WYSIWYG”، فهذه البرامج تُريك أيها الكاتب نتيجةَ عملك في أثناءِ الكتابةِ، كما سيراها القارئُ بعد تمامِها، فما تخطُّهُ من حروفٍ وما تضعُهُ من تنسيقٍ، تراهُ في لحظتِهِ كما سيراهُ القارئُ بعد نشرِهِ وإتمامِهِ. أما في لغة الماركداون تكتب ما تكتبه ولن ترى نتيجته الآن، كأنك تبرمج برنامجًا وتكتبه في ملف ثم تشغله وترى عمله.
مثلًا في برنامج Microsoft Word تكتب السطر وتعينه بأنه العنوان وتثخنه هكذا تثخين bold، وما تراه هو ما ستناله، فهو نفسه سيصدر للقارئ، أما إذا كتبت بلغة الماركداون سيكون الملف هكذا:

شتهرت اللغة وكتب بها الناس لسهولتها ولأن كل واحد يكتب ما يشاء بلا برامج ثقيلة تتبع نهج ما تراه هو ما ستناله WYSIWYG، فأنا وأنت وهي وهو وكل أحد قد يكتب بها متسندًا Document أو كتابًا أو ملاحظة وما شاء له أن يكتب، كل هذا من ملف نصي text. ونعم مثلما قرأت من ملف نصي ينتهي باللاحقة (.md). والكتاب الذي ستكتبه بها ليست بذاك التقدم الذي تمكنه لك البرامج مثل مايكروسوفت ورد مثلًا، لكنها كافية لكتاب كتاب يسير بلا زخرفة وتنميق كبير.

قلت إنها لغة تنسيق، أي تنسق ما تكتبه، ولكل لغة نحو Syntax، قواعد تخبرك كيف تستعمل اللغة، وسنشرع بأولها، ألا وهي العناوين!

العناوين

العنوان الذي تراه أمامك فوق هذا السطر، كيف نكتبه في لغة الماركداون يا مبعسس؟

اعلم أن العناوين لها أحجام، فمنها الصغير ومنها المتوسط، والعناوين نكتبها بإضافة العلامة المربع هذا # متبوعًا بمسافة ثم نكتب العنوان المراد، مثلًا افتح برنامج أوبسيديان واكتب هذا:

# العنوان الأول

ثم انزل لسطر جديد، في برنامج أوبسيديان سترى النص صار عنوانًا واختفت علامة المربع #، كأنك تستعمل برامجًا تتبع نهج ما تراه هو ما ستناله WYSIWYG، وهذه مزية في البرنامج حتى يظهره لك في منظر حسن.

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

# العنوان الأول

## العنوان الثاني

### العنوان الثالث

#### العنوان الرابع

##### العنوان الخامس

###### العنوان السادس

هل فهمت الآن لماذا اسمها لغة التنسيق؟ النص هو النص، لكنه منسق، أضفنا له المربع فصار عنوانًا.

الفقرات

هب أنك كتبت فقرة عن شيء ما، فقرة لخصت فيها شيئًا درسته، كيف تفصل بين هذه الفقرة وما يليها؟

قد تقول سأنتقل للسطر الثاني وهكذا تكون كل فقرة في سطر منفرد، وقد أحسنت جوابًا، لكن هذا لا أثر له في لغة الماركداون، فحتى تفصل بين فقرة وما يليها عليك أن تضيف سطرًا جديدًا فارغًا، وإذا أضفت أكثر من سطر فارغ فإنهم سيُعدَّان سطرًا واحدًا فارغًا!

ستقول يا مبعسس أخطأتَ، فأنا -القارئ- ذهبتُ أطبق هذه المعلومة وأضفتُ سطورًا فارغة ولم تُعدّ سطرًا واحدًا!

وهذا أيها الكريم لأنك في حال التحرير الآن edit mode/view وعليك الانتقال إلى حال القراءة وسترى العلة!

التنقل بين هذين الحالين سهل، انظر في زاوية البرنامج وسترى كتابًا أو قلمًا:

إن كان كتابًا فأنت في حال التحرير ويقول لك اضغط على الكتاب حتى تصير إلى حال القراءة، وإن كان قلمًا فهو يقول لك اضغطني لتدخل حال التحرير فأنت الآن في حال القراءة.

بالمختصر: الكتاب يدل على أنك في حال التحرير، والقلم يدل على أنك في حال القراءة.

وقبل ختام الفقرة، إن أردت رسم خط يقسم الشاشة قسمين فاستعمل ثلاث نجمات *** في سطر منفرد أو استعمل ثلاث شرطات سفلية ___ أو ثلاث شرطات عادية —

تنسيق الكلام

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

التثخين bold

قد تكتب فقرة وتود أن تثخن كلمة bold، أي أن تميزها هكذا تثخين، فكيف تفعل هذا؟

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

الإمالة Italic

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

وللجمع بين الثخين والإمالة معًا لنصٍّ، كهذا النص، فاستعمل ست نجمات أو ست شرطات سفلية وادخل الكلام في المنتصف: ***كلام ممال ومثخن***.

الشطب Strikethrough

وإن أردت شطب كلمة، أي أن يتوسطها خطّ هكذا شطب فاستعمل أربع من هذه العلامة المتوجة ~، ادخل الكلمة بين أربعٍ منها: ~~شطب~~.

التمييز Highlight

وإن أردت تمييز سطر أو كلمة كأنك تمسك قلم التمييز الأصفر وتلون الكلمة أو الجملة كلها في الكتاب هكذا تمييز، فادخل الكلام في منتصف أربع علامات مساوات: == ميز هذا النص==.

ويجوز الجمع بين أكثر من واحد لنفس الكلمة كهذه (يجوز ولا يجوز)، وكتبتها هكذا: ==***يجوز ~~ولا يجوز~~***==

انسخها وجرب أيها القارئ الكريم!

وقبل الانتقال إلى الفقرة التالية ألم تفكر قائلًا: جميل كل هذا، لكن ماذا لو أني أردت كتابة نجمتين لأي سبب ولم أشأ من البرنامج أن يفسرها، فكيف أفعل؟

لإخبار البرنامج أن يترك هذه العلامة بلا تفسير لها ضع قبلها الشرطة المائلة للخلف backslash هذه \ هكذا: \*\*هذا الكلام لن يثخَّن \*\*

تضمين الروابط

إن أردت تضمين كلامٍ رابطًا إذا ضغطت على الكلام وجهك إلى الرابط مثل هذا: (زر موقعنا لتكسب الجوائز) فأمره سهل، تضع الكلام بين معقوفين [زر موقعنا لتكسب الجوائز] ثم اتبعه وضع الرابط بين حاضنتين (https://allunlocker.com/):

[زر موقعنا لتكسب الجوائز](https://allunlocker.com/)

انسخه وجربه!

الصور

إن أردت إضافة صورة في كلامك فاستعمل نفس طريقة تضمين الرابط لكن بإضافة علامة ! قبل المعقوفين، وفي الحاضنتين () ضع مسار الصورة إن كان في حاسوبك، وإن كان عندك رابطها فضع الرابط.

إذا نسخت هذا وجربته عندك سترى رجل (جربها لتراه):


لكن إذا كانت الصورة على حاسوب ضع في مكان الرابط مسارها على حاسوب، مثلا عندي صورة في التنزيلات سأكتب:


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


وإن كانت في مجلد داخل المجلد الحالي كتبت مسار الصورة من المجلد الحالي إليها، مثلا عندك مجلد اسمه  images، والصورة داخله، إذن ستكتب في مكان الرابط:


الاقتباس

إن أردت وضع اقتباس مثل اقتباس كلام الشيخ محمد محمود الشنقيطي:

الناس يظلمون الشعراء، فقلما يترحمون عليهم، بل علينا أن نترحم عليهم وندعو لهم، فهم سلف لنا وكسائر المسلمين يستحقون الترحم عليهم.

فاستعمل هذه العلامة > ثم اكتب بعدها الاقتباس. جرب نسخ كلام أبي حيان التوحيدي هذا:

> ومِن تمام مصابك أنّه لا مفجوع به غيرك، ولا باكٍ لك سواك؛ فعلىٰ نفسك نُحْ إن كنتَ لا بُدَّ تنوح!

اللائحة

إن أردت إنشاء لائحة فعندك طرائق منها استعمال النجمة * مفردة ثم اكتب الغرض بعدها، أو استعمل الشرطة – هذه أو علامة الزائد، انسخ هذا وجربه:

* الغرض الأول

* الغرض الثاني

النتيجة:

• الغرض الأول
• الغرض الثاني

وإن أردت من اللائحة أن تكون مرقمة فاكتب الرقم ثم اتبعه بنقطة أو بنصف حاضنة ) هكذا:

1. الغرض الأول

أو هكذا:

1) الغرض الأول

لائحة المهمات

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

– [ ] المهمة الأولى

– [ ] المهمة الثانية

الرماز Code

ويا أيها المبرمج! إذا أردت كتابة رمازك Code استعمل ست علامات من هذه ~~~ المتموجات:

~~~

js
function fancyAlert(arg) {
if(arg) {
$.facebox({div:’#foo’})
}
}

~~~

أو استعمل ستا من هذه “`:

“`
function fancyAlert(arg) {
if(arg) {
$.facebox({div:’#foo’})
}
}

“`

وإن أردت من أبسيديان أن يلون لك الرماز حسب لغة البرمجة فضع بعد الثلاث العلامات “` هذه اسم لغة البرمجة، مثلًا سأضع js حتى أقول له إنها لغة جافاسكربت:

js“`
function fancyAlert(arg) {
if(arg) {
$.facebox({div:’#foo’})
}
}

“`

الخاتمة

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

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

أرجو منك تقييم كفاءة المعلومات من أجل تزويدي بالملاحظات والنقد البناء في خانة التعليقات أو عبر حساب الموقع، والسلام عليكم ورحمة اللّٰه تعالى وبركاته.