البداية

ما هي ماركداون؟

ماركداون هي لغة ترميز خفيفة تستطيع استخدامها لإضافة التنسيقات للنص العادي. أنشأها جون جروبر (John Gruber) في عام 2004، والآن أصبحت ماركداون من أشهر لغات الترميز على مستوى العالم.

استخدام ماركداون يختلف عن استخدام المحررات التي يتطابق فيها شكل النص أثناء تحريره مع نتيجته النهائية والتي تختصر إلى (WYSIWYG) وهي اختصار للحروف الأولى من جملة: “ما تراه هو ما تحصل عليه” بالإنجليزية، ففي تطبيقات مثل Microsoft Word، عندما تنقر على زر لتنسيق الكلمة أو العبارة، فهي تتغيّر على الفور. أما لغة ماركداون فليست كذلك، فعندما تكتب ملفًا بتنسيق ماركداون، فأنت تضيف قواعد ماركداون إلى النص لتبيّن أيًا الكلمات والعبارات مختلفة التنسيق عن بقية النص.

فعلى سبيل المثال، للدلالة على العنوان، فأنت تضيف علامة “#” يتبعها العنوان فتكون كالتالي: “# عنوان أول “، أو إذا أردت أن يكون خَط عِبارة ما سميك أو غليظ، ستضيف نجمتين “**” قبل وبعد النص المراد زيادة سُمكِه فتكون كالتالي: هذا النص سَميكُ الخط.

قد تستغرق وقتًا حتى تعتاد على قواعد ماركداون في نصوصك، خصوصًا لو كنت ممّن اعتادوا المحررات المرئية الشهيرة (WYSIWYG). تعرض لقطة الشاشة بالأسفل ملف ماركداون معروضًا على المحرر البرمجي Visual Studio Code.

تستطيع إضافة تنسيقات ماركداون للنص العادي باستخدام محررات النصوص، أو يمكنك استخدام واحد من بين العديد من تطبيقات ماركداون على أنظمة التشغيل المختلفة: macOS و Windows و Linux و iOS و Android. وهناك كذلك العديد من التطبيقات المبنية على الويب المصمّمة خصيصًا لماركداون.

بحسب التطبيق الذي تستخدمه، قد لا تكون قادرًا على عرض المستند المنسّق آنيًا أو لحظيا، ولكن هذا لا بأس به. بحسب جروبر (Gruber) فإن قواعد ماركداون صُمّمت لتكون مقروءة وواضحة؛ لذلك فإن النص في ملفات ماركداون يمكن قراءته حتى لو لم يُعرض بعد معالجته في صورته النهائية.

يتمثل الهدف الرئيسي لتصميم قواعد تنسيق ماركداون في جعله مقروءًا قدر الإمكان. تَكمُن الفكرة هي أن المستند المنسق بماركداون يجب أن يكون قابلاً للنشر كما هو، كنص عادي، دون أن يبدو أنه قد مُلئ بالعلامات أو رموز التنسيق.

لماذا تستخدم ماركداون؟

قد تتساءل لماذا أستخدم ماركداون عوضًا عن المحررات المرئية الآنيّة (WYSIWYG). لماذا أكتب بماركداون عندما يمكنني استعمال الأزرار الجاهزة لتنسيق النص في الواجهة؟ كما اتضح، هناك عدة أسباب مختلفة تجعل الناس يستخدمون ماركداون بدلاً من المحررات المرئية الآنية (WYSIWYG).

• يمكن استخدام ماركداون في كل شيء، يستخدمها الناس لإنشاء المواقع، والمستندات، والملاحظات، والكتب، والشرائح التقديمية، ورسائل البريد الإلكتروني، والتوثيقات التقنية.

• ماركداون هي صيغة متنقّلة. يمكن فتح الملفات التي تحتوي على نص منسّق بماركداون باستخدام أي تطبيق تقريبًا. إذا لم يَرُقْ لك تطبيق ماركداون الذي تستخدمه حاليًا، فيمكنك استيراد ملفاته إلى تطبيق ماركداون آخر، بطريقة معاكسة تمامًا مع تطبيقات معالجة الكلمات مثل Microsoft Word التي تقيّد محتواك في تنسيق خاص بها.
• ماركداون مستقلة من المنصات الأخرى. تستطيع إنشاء نص بتنسيق ماركداون على أي جهاز بأي نظام تشغيل.
• ماركداون هي تقنية آمنة / مستدامة. حتى لو توقف البرنامج الذي تستخدمه في وقت من الأوقات، ستكون قادرًا على قراءة النص المنسّق بماركداون باستخدام محرر النصوص. يعد هذا أحد الاعتبارات المهمة عندما يتعلّق الأمر بالكتب والأطروحات الجامعية والوثائق المهمة الأخرى التي تحتاج إلى الاحتفاظ بها إلى أجل غير مسمى.
• صيغة ماركداون موجودة في كل مكان. تدعمها مواقع مثل Reddit و GitHub، والكثير من التطبيقات تدعم ماركداون في سطح المكتب وفي الويب.

سبر الأغوار

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

لست مضطرًا لتنزيل أي شيء. هناك العديد من محررات ماركداون على الإنترنت التي تمكّنك من الكتابة بماركداون. محرر دوّن من أفضل محرّرات ماركداون التي تدعم اللغة العربية على الإنترنت بحيث يمكنك تنصيبه على iOS و Android ومختلف أنظمة التشغيل. افتح الموقع وابدأ في الكتابة في الجزء الأيمن فتظهر معاينة المستند المكتوب في الجزء الأيسر.

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

كيف تعمل؟

يُسهّل محرّر دَوّن الكتابة بماركداون لأنه يخفي ما يحدث خلف الكواليس، ولكن الأمر جدير باستكشاف كيفية عمل العملية عمومًا.

عندما تكتب بماركداون، يُخزّن النص في ملف نص عادي بامتداد md. أو markdown..ثم ماذا؟ كيف يتحوّل ملف ماركداون إلى صيغة HTML أو مستند جاهز للطباعة؟

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

تستخدم تطبيقات ماركداون شيئًا يسمى معالج ماركداون (يشار إليه كذلك باسم “المحلّل اللغوي” Parser أو “التنفيذ” (Implementation) لأخذ النص المنسق بصيغة ماركداون وإخراجه بتنسيق HTML. في هذه المرحلة، يمكن عرض مستندك في متصفح ويب أو دمجه مع صفحة التنسيقات (Style Sheet) وطباعته. يمكنك رؤية تمثيل مرئي لهذه العملية أدناه.

للتلخيص، هذه عملية من أربعة أجزاء:

1. أنشئ ملف ماركداون باستخدام محرر نصوص أو تطبيق ماركداون مخصص. يجب أن يحتوي الملف على امتداد md. أو markdown..

2. افتح ملف ماركداون بتطبيق مخصص لهذا الغرض.

3. استخدم التطبيق لتحويل ملف ماركداون إلى مستند HTML.

4. اعرض ملف HTML في متصفح الويب أو استخدم تطبيق ماركداون لتحويله إلى تنسيق آخر للملفات، مثل تنسيق PDF.

من وجهة نظرك، ستختلف العملية إلى حد ما اعتمادًا على التطبيق الذي تستخدمه. فمثلًا، يجمع محرر دوّن الخطوات من 1 إلى 3 في واجهة واحدة سَلِسَة؛ كل ما عليك فعله هو الكتابة في الجزء الأيمن وسيظهر التنسيق النهائي بطريقة سحرية في الجزء الأيسر. ولكن إذا كنت تستخدم أدوات أخرى مثل محرر نصوص مع منشئ مواقع ويب ساكنة (Static Site Generator)، فستجد أن العملية أكثر وضوحًا.

ما الجيّد في ماركداون؟

هي طريقة سريعة وسهلة لتدوين الملاحظات وإنشاء محتوى لموقع ويب وإنتاج مستندات جاهزة للطباعة.

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

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

المواقع الإلكترونية

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

لو كنت تبحث عن أسهل طريقة لإنشاء موقع ويب باستخدام ملفات ماركداون، فألقِ نظرة على موقع blot.im. بعد التسجيل في موقع Blot، ينشئ مجلد Dropbox على حاسوبك. بمجرد السحب والإفلات لملفات ماركداون (وفورًا!) صارت الملفات في موقعك. لا يوجد أسهل من هذا.

إذا كنت معتادًا على استخدام HTML و CSS ونظام التحكّم في الإصدارات، فراجع برنامج Jekyll، وهو منشئ مواقع ساكنة (Static Site Generator) مشهور يأخذ ملفات ماركداون ويبني بها موقع ويب. تتمثل إحدى ميزات هذه الطريقة في أن خدمة GitHub Pages توفّر استضافة مجانية لمواقع الويب التي ينشئها Jekyll. إذا لم يكن Jekyll هو أسلوبك المفضل، فما عليك سوى اختيار واحد من العديد من مولدات المواقع الساكنة المتاحة.

إذا كنت ترغب في استخدام نظام إدارة المحتوى (CMS) لتشغيل موقعك فألق نظرة على نظام Ghost. إنها منصة تدوين مجانية ومفتوحة المصدر مع محرر ماركداون لطيف. إذا كنت من مستخدمي WordPress فسيسعدك معرفة أن هناك دعم ماركداون لمواقع الويب المستضافة على WordPress.com، ويمكن لمواقع WordPress ذاتية الاستضافة استخدام المكوّن الإضافي Jetpack.

المستندات

لا تحتوي ماركداون على جميع إمكانيات معالجات الكلمات مثل Microsoft Word، ولكنها جيدة بما يكفي لإنشاء مستندات أساسية مثل التكاليف المدرسية والرسائل. يمكنك استخدام تطبيق ماركداون لكتابة المستندات وإنشاء وتصدير مستندات بتنسيق ماركداون إلى ملف بتنسيق PDF أو HTML. يعد تنسيق PDF جزءًا أساسيًا؛ لأنه بمجرد حصولك على مستند PDF، يمكنك فعل أي شيء به، إما طباعته أو إرساله بالبريد الإلكتروني أو رفعه على موقع إلكتروني.

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

• نظام ‏Mac‎:‏ ‎MacDown أو iA Writer أو Marked 2
• نظام iOS / Android:‏ iA Writer
• نظام Windows:‏ ghostwriter أو Markdown Monster
• نظام ‏Linux:‏ ReText أو ghostwriter
• على الويب: Dillinger أو StackEdit

الملاحظات

من جميع النواحي تقريبًا، تعدّ ماركداون الصيغة المثالية لتدوين الملاحظات. للأسف، لا يدعم تطبيقا Evernote ولا OneNote ماركداون حاليًا، وهما من أكثر تطبيقات الملاحظات شيوعًا. والخبر السار هو أنّ العديد من تطبيقات الملاحظات الأخرى تدعم ماركداون:

• - Simplenote هو تطبيق مجاني لتدوين الملاحظات متاح في كل المنصات.
• - Notable هو تطبيق تدوين للملاحظات يعمل على مجموعة متنوعة من المنصات.
• - Bear هو تطبيق يشبه Evernote متاح لأجهزة Mac و iOS. لا يستخدم ماركداون حصريًا افتراضيًا، ولكن يمكنك تفعيل وضع توافق ماركداون.
• - Joplin هو تطبيق لتدوين الملاحظات يحترم خصوصيتك. متاح لكل منصة.
• - Boostnote تطبيق يَعُدّ نفسه “تطبيقًا مفتوح المصدر لتدوين الملاحظات مصمم للمبرمجين”.

إذا لم تتمكن من التخلي عن Evernote، فألق نظرة على Marxico، وهو محرر ماركداون قائم على الاشتراك لـ Evernote، أو استخدم إضافة Markdown Here على المتصفح أثناء الكتابة على موقع Evernote الإلكتروني.

الكتب

هل تتطلع إلى نشر رواية بنفسك؟ جرب Leanpub، وهي خدمة تأخذ ملفات ماركداون خاصتك وتحوّلها إلى كتاب إلكتروني. تُخرج Leanpub كتابك بتنسيق ملفات PDF و EPUB و MOBI. إذا كنت ترغب في إنشاء نسخ ورقية من كتابك، فيمكنك تحميل ملف PDF إلى خدمة أخرى مثل Kindle Direct Publishing. لمعرفة المزيد عن تأليف كتاب ونشره ذاتيًا باستخدام ماركداون فاقرأ هذه التدوينة.

العروض التقديمية

صَدّق أو لا تصدّق، يمكنك إنشاء عروض تقديمية من ملفات ماركداون المنسقّة. يستغرق إنشاء العروض التقديمية باستخدام ماركداون القليل من التعوّد، ولكن بمجرد أن تتعوّد عليه، فإنه يصبح أسرع وأسهل بكثير من استخدام تطبيق مثل PowerPoint أو Keynote. مشروع Remark (رابطه على GitHub) هو أداة عرض شرائح ماركداون قائمة على المتصفح، مثل Cleaver (رابطه على GitHub) و Marp (رابطه على GitHub). إذا كنت تستخدم جهاز Mac وتفضّل استخدام تطبيق (عوضًا عن برمجيات مبنية على المتصفح)، فاطلّع على Deckset أو Hyperdeck.

البريد الإلكتروني

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

المشاركة

تعد تطبيقات المشاركة والمراسلة الجماعية طريقة شائعة للتواصل مع الزملاء والأصدقاء في العمل والمنزل. لا توفّر هذه التطبيقات جميع ميزات ماركداون، ولكن الميزات التي توفّرها مفيدة إلى حد ما. مثلًا، تُعدّ القدرة على تسميك / تغليظ النص أو إمالته في متناول اليد دون استخدام المحررات المرئية (WYSIWYG).‏ تعد كلًا من Slack و Discord و Wiki.js وMattermost تطبيقات مشاركة جيدة.

التوثيق

تعد ماركداون مناسبة تمامًا للتوثيقات التقنية (Technical Documentation). شركات مثل GitHub تتحول أكثر فأكثر إلى ماركداون لتوثيقاتها، راجع التدوينة الخاصة بشركة Github حول كيفية ترحيلهم لوثائقهم المنسّقة بماركداون إلى Jekyll. إذا كتبت توثيقات لمنتج أو خدمة، فألق نظرة على هذه الأدوات المفيدة:

• Read the Docs يمكن أن تنشئ موقعًا للتوثيق من ملفات ماركداون مفتوحة المصدر. ما عليك سوى توصيل مستودعك في GitHub بخدمتهم ورفعها إلى الخدمة. ستتكفل “Read the Docs” بالباقي. لديهم أيضًا خدمة للمؤسسات التجارية.
• MkDocs هو منشئ مواقع ساكنة (Static Site Generator) سريع وسهل ومعد لإنشاء توثيق المشروع. تُكتب ملفات مصدر التوثيق بماركداون وإعدادها باستخدام ملف إعدادات YAML واحد. يحتوي MkDocs على العديد من القوالب المضمّنة، بما في ذلك منفذ توثيق قالب Read the Docs لكي يعمل مع MkDocs. من أحدث القوالب قالب MkDocs Material.
• Docusaurus هو منشئ مواقع ساكنة (Static Site Generator) مصمم حصريًا لإنشاء مواقع الويب الخاصة بالتوثيق. وهو يدعم الترجمات، والبحث، والإصدارات.
• VuePress هو منشئ مواقع ساكنة (Static Site Generator) مبنى على مكتبة Vue ومُحسَّن لكتابة التوثيقات التقنية.
• Jekyll ذُكِر سابقًا في القسم الخاص بمواقع الويب، ولكنه أيضًا خَيار جيد لإنشاء موقع ويب للتوثيق من ملفات ماركداون. إذا ذهبت في هذا المسار، فتأكد من الاطلاع على قالب Jekyll للتوثيقات.

تنويعات (نُسَخ) ماركداون

أحد أكثر الجوانب إرباكًا لاستخدام ماركداون هو أن كل تطبيق ماركداون ينفّذ عمليًا إصدارًا مختلفًا قليلاً عن الآخر. يشار إلى هذه المتغيرات من ماركداون باسم التنويعات (Flavors). تتمثل مهمتك في إتقان أي تنويعة لماركداون نَفَّذَها تطبيقك.

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

من الناحية العملية، هذا يعني أنك لا تعرف تمامًا ما تعنيه الشركة عندما تقول إنها تدعم “ماركداون”. أتقصد فقط القواعد الأساسية، أم كل القواعد الأساسية والموسّعة (Extended) معًا، أم مزيجًا عشوائيًا من القواعد؟ لن تعرف حتى تقرأ التوثيق أو تبدأ في استخدام التطبيق.

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

مصادر إضافية

هناك العديد من المصادر التي يمكنك استخدامها لتعلّم ماركداون. هاك بعض المصادر التمهيدية الأخرى (باللغة الإنجليزية):

• توثيق جون جروبر لماركداون. التوثيق الأصلي المكتوب بقلم مخترع ماركداون.
• دروس ماركداون. موقع مفتوح المصدر يسمح لك بتجربة ماركداون في متصفحك.
• ماركداون الرائعة. قائمة بأدوات ماركداون ومصادر تعليمية.
• تنضيد ماركداون. سلسلة متعددة الأجزاء تصف منظومة متكاملة لتنضيد مستندات ماركداون باستخدام أداتي pandoc و ConTeXt.