ماركداون

end

def show_resultsend

و هذا ما يترجم في لغة HTML إلى:

عناوين

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

# مستوى الترويس-(عنونة) أول

القوائم

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

• * عنصر قائمة.
• مع فقرات متعددة.
• * عنصر آخر.
• يترجم إلى لغة html كالتالي:
• عنصر قائمةمع فقرات متعددة
• عنصر آخر

• *عنصر في قائمة غير مرتبة.
• +بند ويضمن 4 مسافات بادئة.
• *عنصر آخر في قائمة غير مرتبة.
• *كذلك عنصر آخر.
• وهذا يترجم إلى:
• عنصر في قائمة غير مرتبة.
• بند ويضمن 4 مسافات بادئة.
• عنصر آخر في قائمة غير مرتبة.
• كذلك عنصر آخر.

• 1. عنصر في قائمة تعداد.
• 1. A بند فرعي، بادئة مع 4 مساحات.
• 2. بند آخر في قائمة تعداد.
• 3. بند آخر.
• 4. بند آخر.
• وهذا يترجم بلغة html إلى:
• عنصر في قائمة تعداد.
• بند فرعي، بادئة مع 4 مساحات.
• بند آخر في قائمة تعداد.
• بند آخر.
• بند آخر.

وعلى صعيد آخر، يتم إنشاء قائمة غير مرتبة عن طريق وضع عدد من المسافات البادئة و «الرموز النقطية» أمام عنصر القائمة. «الرموز النقطية» تشمل " * "، " + "،" - "

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

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

مستوى ترويس (عنونة) رابع

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

# مستوى الترويس-(عنونة) الأول #

#### مستوى الترويس-(عنونة) الرابع ####

فواصل الأسطر

def␣show_results␣␣

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

#### مستوى الترويس-(عنونة) رابع

مستوى ترويس (عنونة) أول

هذا ما يترجم في لغة HTML إلى:

عناصر الاقتباس قابلة لإعادة التدفق. تستطيع

إنهاءالنص بالشكل الذي يرضيك تعسفياً، وسوف يكون توزيعه

في عنصر الاقتباس فقرة واحدة ".

نص مؤكد

• علامات الاقتباس الخلفية يمكن أن تستعمل في الجملة لتمثيل الكود:
• نص ما مع ` شيفرة برمجية ما ` بداخله
• هذا ما يترجم في لغة HTML إلى:

• أرفق مع اثنين من العلامات النجمية أو يبرز ويمثل بحروف بارزة.
• تركيز قوي (بحروف بارزة) ** أو __ تركيز قوي (بحروف بارزة) __
• النص البرمجي (الشيفرة)

ومن جهة أخرى، التركيز (مائل) * أو توكيد (مائل) _وهذا يترجم إلى: التركيز (المائل) </ EM> أو التركيز (المائل) </ EM>

كذلك، النص المؤكد يمكن أن يكون بنى جمل متعددة، إما ترفق مع العلامات النجمية أو تبرز. مرفق مع علامة نجمية واحدة أو تسطير يمثل المائل.

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

نص ما مع شيفرة برمجية ما بداخله

من جهة ثانية، الشيفرات البرمجية التي تتوضع على عدة أسطر أو القطع الأطول من الكود يجب أن تسبق بأربع مسافات بادئة كما المثال:

سطر 2 من الكود

سطر 1 من الكود

سطر 3 من الكود

الاقتباس

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

سطر 3 من الكود

• هذا ما يترجم في لغة HTML إلى:
• سطر 1 من الكود
• سطر 2 من الكود

صور

• يترجم إلى لغة html كالتالي:
• يمكن إضافة حاشية للصور مثل الروابط:
• كما يجب الإشارة إلى أنه يجب تحديد url لاحقاً في المستند.
• [id]: url/to/image "العنوان الاختياري"

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

للصور تركيب مشابه ليربط مع علامة التعجب السابقة.

هذا يترجم إلى لغة html كالتالي:

يمكن إنشاءاقتباس بإضافة >

> "سيتم إحاطة هذه الفقرة بأكملها من النص في عنصر اقتباس.

عناصر الاقتباس قابلة لإعادة التدفق. تستطيع

• إنهاءالنص بالشكل الذي يرضيك تعسفياً، وسوف يكون توزيعه
• في عنصر الاقتباس فقرة واحدة ".
• ويترجم إلى نص html كالتالي:
• "سيتم إحاطة هذه الفقرة بأكملها من النص في عنصر اقتباس.

المحررات

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

## مستوى الترويس-(عنونة) الثاني ##

• مستويا العنونة الأول والثاني يمكن أن يستعملا قاعدة لغوية أخرى للتعبير عنهما:
• مستوى الترويس-(عنونة) الأول
• مستوى الترويس-(عنونة) الثاني
• --------------------

الفقرات

• هذه فقرة. وهي مكونة من جملتين.
• هذه فقرة أخرى. وتتكون من جملتين كذلك.
• يترجم المثال أعلاه إلى:
• هذا الفقرة. فقد اثنين من الجمل. </ P>
• هذا فقرة أخرى. كما أن لديها جملتين. </ P>

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

تطبيقها

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

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

وعلى صعيد آخر، تطبق المارك داون في كثير من الأطر المختلفة، والمنصات واللغات.

وعلى صعيد آخر، ملتيماركداون صيغة وبرنامج يمتلك مميزات أكثر في قواعد اللغة وخيارات التصدير من المارك داون التقليدية

ومن ناحية أخرى، «الغيتهاب يفضل المارك داون»(GFM) ولها الكثير من التطبيقات. ويضيف GFM تعليم الصيغة وقائمة المهام إلى الماركدوان القياسية.

وفي السياق ذاته، مولد التوثيق المصدري دي أكسجين يدعم المارك داون مع ميزات اضافية. * *آرستدويو هي بيئة تطوير متكاملة من R يوفر ميزة تغليف التوابع بالسي++ لتنفيذ الماركدوان ببرمجيات سنداون.

---------------------------------------

جميعا تُترجم في HTML إلى .

مسطرة أفقية

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

• ***
• ***
• *****
• ---

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

علاوةً على ذلك، لمقارنة خرج التطبيقات المختلفة«و» تشجيع المناقشة لتوضيح بعض الجوانب الغامضة من مواصفات المارك داون.

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

". والآن تتوفر أداة تسمى "Babelmark2" )

• انظر كذلك
• جون غروبر
• آرون سوارتز
• مراجع