# ماركداون

ماركداون (بالإنجليزية: MarkDown)‏ هي رموز للتنسيق تعتمد على لغة ترميز بسيطة، أنشأها جون غروبر وساهم فيها آرون سوارتز، تسمح بكتابة محتوى نصي بسيط يتميز بسهولة الكتابة والقراءة، ثم تحويله إلى لغة HTML أو XHTML.
وهي تأخذ العديد من التعليمات من الأعراف الحالية التي تستخدم لترميز نص عادي في البريد الالكتروني. النص المنسق بواسطة تلك الرموز ينبغي أن يكون قابلاً للقراءة كما هو، من دون النظر إلى التوصيفات وعلامات التنسيق (بالإنجليزية: tags)‏،
على عكس النص المنسق بلغة توصيف أخرى مثل HTML، التي لديها تنسيقات واضحة وتعليمات تنسيق معينة. ماركداون تقوم ببناء جملة منسقة مقروءة وأيضاً يمكن تحويلها إلى HTML بسهولة.
الماركداون هو مخطوطة بيرل كتبها غروبر (بالإنجليزية: Markdown.pl)‏ والتي تحول النص المدخل المرمز إلى نص HTML أو XHTML صالح. ويمكن استخدامها كبرنامج نصي مستقل أو كبرنامج مساعد (بالإنجليزية: plugin)‏ لبلوزكسوم أو موفابل تايب أو كمرشح نصوص ل BBEdit.
منذ ذلك الحين أصبح يمكن استخدامها من قبل الآخرين بوصفها كتلة برمجية من بيرل متوفرة في أرشيف شبكة بيرل الشامل، واستخدمت أيضاُ في مجموعة لغات برمجة متنوعة. يتم توزيعه تحت رخص بي إس دي ويمكن أن يُتضمن أو يكون متاحاً كبرنامج مساعد للعديد من أنظمة إدارة المحتوى.
تستخدم هذه اللغة في مواقع مثل غيت هاب، وريديت وستاك أوفرفلو، وسورس فورج.نت لتسهيل المناقشة بين المستخدمين.

## أمثلة على قواعد اللغة
### عناوين

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

### الفقرات

الفقرة: هي سطر واحد أو أكثر من النص يفصل بينها سطر فارغ أو أكثر.لا ينبغي أن تبدأ الفقرات العادية بمسافة بادئة أو بعلامات تبويب.
يترجم المثال أعلاه إلى:

### فواصل الأسطر

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

### القوائم

هناك نوعين من تصنيف القوائم: قوائم مرتبة وقوائم غير مرتبة كما في لغة html.
يتم إنشاء قائمة غير مرتبة عن طريق وضع عدد من المسافات البادئة و «الرموز النقطية» أمام عنصر القائمة. «الرموز النقطية» تشمل " * "، " + "،" - "
وهذا يترجم إلى:
أما بالنسبة للقوائم المرتبة قد لاتحتاج القوائم أن تكون مرتبة بما يوافق ترتيب العناصر.
وهذا يترجم بلغة html إلى:
إذا وضعت أسطر فارغة بين العناصر، وستُحلل على أنها فقرات. يمكن إنشاء قائمة عناصر لائحة متعددة الفقرات من خلال المسافات البادئة بنسبة 4 مسافات(بالإنجليزية: spaces)‏ أو علامة التبويب (بالإنجليزية: tabs)‏. على سبيل المثال:
يترجم إلى لغة html كالتالي:

### نص مؤكد

النص المؤكد يمكن أن يكون بنى جمل متعددة، إما ترفق مع العلامات النجمية أو تبرز. مرفق مع علامة نجمية واحدة أو تسطير يمثل المائل.
* التركيز (مائل) * أو توكيد (مائل) _وهذا يترجم إلى: <EM> التركيز (المائل) </ EM> أو <EM> التركيز (المائل) </ EM>
أرفق مع اثنين من العلامات النجمية أو يبرز ويمثل بحروف بارزة.
** تركيز قوي (بحروف بارزة) ** أو __ تركيز قوي (بحروف بارزة) __

### النص البرمجي (الشيفرة)

لإدراج نص برمجي (منسق بخط ثابت العرض)، بإمكانك إما أن تحيط الكود المضمن بإشارات اقتباس خلفية (`) أو أن تبدأ السطور العديدة من الكود على الأقل مع أربع مسافات بادئة علامات الاقتباس الخلفية يمكن أن تستخدم في الجملة لتمثيل الكود:
هذا ما يترجم في لغة HTML إلى:
الشيفرات البرمجية التي تتوضع على عدة أسطر أو القطع الأطول من الكود يجب أن تسبق بأربع مسافات بادئة كما المثال:
هذا ما يترجم في لغة HTML إلى:
الخيار الثاني يجعل ماركداون تحتفظ بالمسافات الفارغة -على عكس السلوك المعتاد للغة الذي يعمل على إزالة فواصل الأسطر والمسافات الزائدة، قد يتم كسر المسافات البادئة وتغيير المظهر الخارجي للكود.

### الاقتباس

يمكن إنشاءاقتباس بإضافة >
ويترجم إلى نص html كالتالي:

### صور

للصور تركيب مشابه ليربط مع علامة التعجب السابقة.
هذا يترجم إلى لغة html كالتالي:
يمكن إضافة العنوان بشكل اختياري إلى نهاية عنوان الرابط بين علامتي اقتباس كما هو موضح:
يترجم إلى لغة html كالتالي:
يمكن إضافة حاشية للصور مثل الروابط:
كما يجب الإشارة إلى أنه يجب تحديد url لاحقاً في المستند.

### مسطرة أفقية

يتم إنشاء مسطرة أفقية (خط أفقي فاصل) بكتابة ثلاثة أو أكثر من الشرطات أو الشرطات السفلية أو النجوم. ويمكن إضافة مسافات بينها. كل من الأسطر التالية سوف ينتج مسطرة أفقية:
جميعا تُترجم في HTML إلى <hr />.

## المحررات

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

## تطبيقها

تطبق المارك داون في كثير من الأطر المختلفة، والمنصات واللغات.
* مولد التوثيق المصدري دي أكسجين يدعم المارك داون مع ميزات اضافية. * *آرستدويو(بالإنجليزية: Rstdio)‏ هي بيئة تطوير متكاملة من R يوفر ميزة تغليف التوابع بالسي++ لتنفيذ الماركدوان ببرمجيات سنداون.
* إنتيليج إيديا، هي بيئة تطوير متكاملة للجافا، وتدعم الماركداون كبرنامج مساعد.
* ملتيماركداون صيغة وبرنامج يمتلك مميزات أكثر في قواعد اللغة وخيارات التصدير من المارك داون التقليدية
* «الغيتهاب يفضل المارك داون»(GFM) ولها العديد من التطبيقات. ويضيف GFM تعليم الصيغة وقائمة المهام إلى الماركدوان القياسية.
وهناك الكثير من التطبيقات المفتوحة المصدر المتوفرة على شبكة الإنترنت.

## توحيد المعايير

ليس هناك معايير محددة للماركداون بوضوح، عدا عن writeup الأصلي المنفذ من قبل جون غروبر. في أواخر عام 2012، بدأ جهد لتوحيد المعايير القياسية، كان السبب غالباً تدوينة من مدونة جيف أتوود. يسعى مجتمع الإنترنت الآن إلى "وثيقة متنوعة من الأدوات والموارد المتاحة لمؤلفي المستندات والمطورين، فضلاً عن المنفذين لمختلف تطبيقات الماركداون ". والآن تتوفر أداة تسمى "Babelmark2") لمقارنة خرج التطبيقات المختلفة«و» تشجيع المناقشة لتوضيح بعض الجوانب الغامضة من مواصفات المارك داون.

## انظر أيضا

* جون غروبر
* آرون سوارتز

## مراجع

* 1 2 Markdown 1.0.1 readme source code "Daring Fireball - Markdown". 17-Dec-2004. مؤرشف من الأصل في 9 سبتمبر 2019. {{استشهاد ويب}}: تحقق من التاريخ في: |تاريخ= (مساعدة)
* ↑ Markdown Syntax "Daring Fireball - Markdown - Syntax". 13-Jun-2013. مؤرشف من الأصل في 9 سبتمبر 2019. {{استشهاد ويب}}: تحقق من التاريخ في: |تاريخ= (مساعدة)
* ↑ Daring Fireball: Markdown: License نسخة محفوظة 07 يناير 2018 على موقع واي باك مشين.
* ↑ "MarsEdit 2.3 ties the knot with Tumblr support - Ars Technica". مؤرشف من الأصل في 2011-09-10. اطلع عليه بتاريخ 2009-08-11.
* ↑ "Review: Practical Django Projects - Ars Technica". مؤرشف من الأصل في 2011-06-07. اطلع عليه بتاريخ 2009-08-11.
* 1 2 "GitHub Flavored Markdown". github.com. مؤرشف من الأصل في 2019-02-05. اطلع عليه بتاريخ 2013-03-29.
* ↑ "Reddit markdown primer. Or, how do you do all that fancy formatting in your comments, anyway?". reddit.com. مؤرشف من الأصل في 2019-06-11. اطلع عليه بتاريخ 2013-03-29.
* ↑ "Markdown help". http://stackoverflow.com. مؤرشف من الأصل في 2019-09-10. اطلع عليه بتاريخ 2013-03-29. {{استشهاد ويب}}: روابط خارجية في |ناشر= (مساعدة)
* ↑ "SourceForge: Markdown Syntax Guide". sourceforge.net. مؤرشف من الأصل في 2019-06-13. اطلع عليه بتاريخ 2013-05-10.
* ↑ Doxygen Manual: Markdown support نسخة محفوظة 18 يوليو 2017 على موقع واي باك مشين.
* ↑ rstudio/Markdown.cpp at master · rstudio/rstudio · GitHub نسخة محفوظة 26 يوليو 2017 على موقع واي باك مشين.
* ↑ JetBrains Plugin Repository :: Markdown نسخة محفوظة 3 مايو 2015 على موقع واي باك مشين. "نسخة مؤرشفة". مؤرشف من الأصل في 2016-03-03. اطلع عليه بتاريخ 2013-09-13.
* ↑ nicoulaj/idea-markdown · GitHub نسخة محفوظة 10 سبتمبر 2013 على موقع واي باك مشين.
* ↑ Joe Esposito. "Grip -- Github Readme Instant Preview". GitHub-Flavored Markdown in the Python language. نسخة محفوظة 10 مايو 2018 على موقع واي باك مشين.
* ↑ Jeff Tratner. "Vim-Flavored-Markdown": Github Flavored Markdown in the فيم سكريبتing language. نسخة محفوظة 03 أغسطس 2015 على موقع واي باك مشين.
* ↑ Evan Solomon. "GitHub-Flavored Markdown Comments": Github Flavored Markdown in the PHP language as a WordPress plugin. نسخة محفوظة 07 مارس 2017 على موقع واي باك مشين.
* ↑ Gabriel Llamas. "Node-GFM": GitHub flavored markdown in the JavaScript language. "نسخة مؤرشفة". مؤرشف من الأصل في 2016-06-14. اطلع عليه بتاريخ 2018-01-31.{{استشهاد ويب}}: صيانة الاستشهاد: BOT: original URL status unknown (link)
* ↑ The Future of Markdown نسخة محفوظة 11 فبراير 2014 على موقع واي باك مشين.
* ↑ Markdown Community Page نسخة محفوظة 21 مارس 2017 على موقع واي باك مشين.
* ↑ Babelmark 2 - Compare markdown implementations نسخة محفوظة 18 يوليو 2017 على موقع واي باك مشين.
* ↑ Babelmark 2 - FAQ نسخة محفوظة 28 يوليو 2017 على موقع واي باك مشين.