ماركداون

عودة للموسوعة
رموز التنسيق (بالإنجليزية: MarkDown)‏
الشعار
امتداد الملف
.md
صيغة وسائط الإنترنت
لغة ترميز
المطور
جون غروبر
أول إصدار
19 مارس 2004
مسقط الويب
daringfireball.net/projects/markdown

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

الماركداون هومخطوطة بيرل خطها غروبر (بالإنجليزية: Markdown.pl)‏ والتي تحول النص المدخل المرمز إلى نص HTML أوXHTML صالح. ويمكن استخدامها كبرنامج نصي مستقل أوكبرنامج مساعد (بالإنجليزية: plugin)‏ لبلوزكسوم أوموفابل تايب أوكمرشح نصوص ل BBEdit.

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

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

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

عناوين

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

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

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

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

 <h1> مستوى ترويس (عنونة) أول</h1>
 <h4> مستوى ترويس (عنونة) رابع</h4>

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

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

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

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

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

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

الفقرات

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

هذه فقرة. وهي مكونة من جملتين.
هذه فقرة أخرى. وتتكون من جملتين أيضاً.

يترجم المثال أعلاه إلى:

<p> هذا الفقرة. فقد اثنين من الجمل. </ P>
<p> هذا فقرة أخرى. كما حتى لديها جملتين. </ P>

فواصل الأسطر

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

def␣show_results␣␣
end

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

 def show_results<br />end

القوائم

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

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

*عنصر في قائمة غير مرتبة.
  +بند ويضمن أربعة مسافات بادئة.
*عنصر آخر في قائمة غير مرتبة.
*أيضاً عنصر آخر.

وهذا يترجم إلى:

<ul>
  <li> عنصر في قائمة غير مرتبة.
    <ul>
      <li> بند ويضمن أربعة مسافات بادئة.</li>
    </ul>
  </li>
  <li>عنصر آخر في قائمة غير مرتبة.</li>
  <li>أيضاً عنصر آخر.</li>
</ul>

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

1. عنصر في قائمة تعداد.
  1. A بند فرعي، بادئة مع أربعة مساحات.
2. بند آخر في قائمة تعداد.
3. بند آخر.
4. بند آخر.

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

<ol>
  <li>عنصر في قائمة تعداد. 
    <ol>
      <li> بند فرعي، بادئة مع أربعة مساحات.</li>
    </ol>
  </li>
  <li> بند آخر في قائمة تعداد.</li>
  <li>بند آخر.</li>
  <li>بند آخر.</li>
</ol>

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

* عنصر قائمة.
  مع فقرات متعددة.
* عنصر آخر.

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

<ul>
  <li><p>عنصر قائمة</p><p>مع فقرات متعددة</p></li>
  <li>عنصر آخر</li>
</ul>

نص مؤكد

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

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

أرفق مع اثنين من العلامات النجمية أويبرز ويمثل بحروف بارزة.

    • هجريز قوي (بحروف بارزة) ** أو__ هجريز قوي (بحروف بارزة) __

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

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

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

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

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

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

  سطر 1 من الكود
  سطر 2 من الكود
  سطر ثلاثة من الكود

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

<pre>
  <code>
سطر 1 من الكود
سطر 2 من الكود
سطر ثلاثة من الكود
  </code>
</pre>

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

الاقتباس

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

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

ويترجم إلى نص html كالتالي:

<blockquote><p> "سيتم إحاطة هذه الفقرة بأكملها من النص في عنصر اقتباس.
عناصر الاقتباس قابلة لإعادة التدفق. تستطيع
إنهاءالنص بالشكل الذي يرضيك تعسفياً، وسوفقد يكون توزيعه
في عنصر الاقتباس فقرة واحدة ".</p></blockquote>

صور

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

![النص البديل](/path/to/img.jpg)

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

<img src="/path/to/img.jpg" alt="النص البديل" />

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

![النص البديل](/path/to/img.jpg "العنوان الاختياري")

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

<img src="/path/to/img.jpg" alt="النص البديل" title="العنوان الاخيتاري" />

يمكن إضافة حاشية للصور مثل الروابط:

![Alt text][id]

كما يجب الإشارة إلى أنه يجب تحديد url لاحقاً في المستند.

 [id]: url/to/image  "العنوان الاختياري"

قواعد أفقية

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

***
***
*****
---
---------------------------------------
كل هذه تترجم إلى HTML أفقي علامة القاعدة.

المحررات

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

تطبيقها

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

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

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

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

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

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

انظر أيضا

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

مراجع

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

روابط خارجية

  • المشروع الرسمي للماركداون على مدونة دارينغ فاير بول
  • صفحة مجتمع المارك داون
تاريخ النشر: 2020-06-02 01:19:41
التصنيفات: اختراعات متعلقة بالحواسيب في 2004, تدوين الملاحظات, لغات الترميز خفيفة الوزن, لغات حاسوب, قالب أرشيف الإنترنت بوصلات واي باك, أخطاء CS1: روابط خارجية, جميع المقالات ذات الوصلات الخارجية المكسورة, مقالات ذات وصلات خارجية مكسورة منذ أغسطس 2017, مقالات تحتوي نصا بالإنجليزية, صفحات تستخدم خاصية P577, صفحات تستخدم خاصية P154, صفحات تستخدم خاصية P18, صفحات تستخدم خاصية P244, بوابة تقنية المعلومات/مقالات متعلقة, بوابة برمجيات/مقالات متعلقة, بوابة عقد 2000/مقالات متعلقة, بوابة علم الحاسوب/مقالات متعلقة, بوابة تقانة/مقالات متعلقة, جميع المقالات التي تستخدم شريط بوابات

مقالات أخرى من الموسوعة

سحابة الكلمات المفتاحية، مما يبحث عنه الزوار في كشاف:

آخر الأخبار حول العالم

السيطرة على تسرب غاز بعد كسر ماسورة فى صفط اللبن

المصدر: موقع الدستور - مصر التصنيف: سياسة
تاريخ الخبر: 2023-03-07 15:21:47
مستوى الصحة: 46% الأهمية: 70%

يضم 97 عارضا.. تفاصيل جناح مصر في بورصة برلين السياحية

المصدر: موقع الدستور - مصر التصنيف: سياسة
تاريخ الخبر: 2023-03-07 15:21:31
مستوى الصحة: 51% الأهمية: 70%

ضبط راكب بـ600 «كبسولة ترامادول» أخفاها داخل أحذيته بمطار القاهرة

المصدر: موقع الدستور - مصر التصنيف: سياسة
تاريخ الخبر: 2023-03-07 15:21:34
مستوى الصحة: 55% الأهمية: 52%

اعترافات صادمة لـ«أنوش»: «بينت جسمى عشان أكسب»

المصدر: موقع الدستور - مصر التصنيف: سياسة
تاريخ الخبر: 2023-03-07 15:21:26
مستوى الصحة: 53% الأهمية: 65%

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

المصدر: موقع الدستور - مصر التصنيف: سياسة
تاريخ الخبر: 2023-03-07 15:21:32
مستوى الصحة: 52% الأهمية: 62%

مقترح مراجعة مدونة الأسرة.. CNDH يكشف أسماء أعضاء مجموعة العمل

المصدر: تيل كيل عربي - المغرب التصنيف: سياسة
تاريخ الخبر: 2023-03-07 15:21:15
مستوى الصحة: 56% الأهمية: 55%

محافظ الإسكندرية يبحث مع سفير بيلاروسيا تعزيز سبل التعاون

المصدر: موقع الدستور - مصر التصنيف: سياسة
تاريخ الخبر: 2023-03-07 15:21:44
مستوى الصحة: 49% الأهمية: 69%

«فصّص لحمها قدامنا».. «الدستور» تخترق جماعات تشريس الكلاب (تحقيق)

المصدر: موقع الدستور - مصر التصنيف: سياسة
تاريخ الخبر: 2023-03-07 15:21:28
مستوى الصحة: 58% الأهمية: 60%

«حقوق عين شمس» تتعاون مع كلية الحقوق بجامعة كوين ماري البريطانية

المصدر: موقع الدستور - مصر التصنيف: سياسة
تاريخ الخبر: 2023-03-07 15:21:31
مستوى الصحة: 54% الأهمية: 69%

برنامج غذائى خاص للاعبى الأهلى خلال رحلتى جنوب إفريقيا والكاميرون

المصدر: موقع الدستور - مصر التصنيف: سياسة
تاريخ الخبر: 2023-03-07 15:21:38
مستوى الصحة: 52% الأهمية: 68%

مجموعة الأهلي.. الهلال السوداني يتقدم على القطن الكاميروني بهدف

المصدر: موقع الدستور - مصر التصنيف: سياسة
تاريخ الخبر: 2023-03-07 15:21:36
مستوى الصحة: 56% الأهمية: 54%

تعرف على تفاصيل الاجتماع الفني لمباراة أسكو كارا وبيراميدز

المصدر: موقع الدستور - مصر التصنيف: سياسة
تاريخ الخبر: 2023-03-07 15:21:38
مستوى الصحة: 56% الأهمية: 54%

شادي حسين يقود هجوم الأهلي أمام المقاولون العرب.. وكهربا بديلا

المصدر: موقع الدستور - مصر التصنيف: سياسة
تاريخ الخبر: 2023-03-07 15:21:24
مستوى الصحة: 60% الأهمية: 50%

تحميل تطبيق المنصة العربية