Markdown

كتب John Gruber صيغة Markdown سنة 2004. ساعد Aaron Swartz أيضاً في العمل الأول. القصد كان إبقاء النص العادي مقروءاً وإخراج HTML منه حين يلزم. العنوان يُكتب بـ # في أول السطر. النص الغليظ يقف بين نجمتين. القائمة تبدأ بشرطة أو نجمة. الرابط يُظهر النص والعنوان بين قوسين. الملف نفسه لا يشغّل شيئاً. الموقع أو البرنامج الذي يقرأه يحوّله إلى HTML. ليس كل موقع يقرأ التفصيل الصغير نفسه بالطريقة نفسها. لذلك جدول يعمل في مكان قد لا يخرج سليماً في مكان آخر.

Markdown للملاحظة وREADME والمستند البسيط. من يقرأ يرى العلامة والنص النظيف.

• كتابة ملف README للمشروع
• حفظ ملاحظة درس قصيرة
• كتابة عنوان وقائمة بسرعة
• تحويل النص إلى HTML لاحقاً

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

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

الميزة: النص يبقى نظيفاً والعلامات قليلة وكثير من المواقع تقرأه. الحد: القاعدة الصغيرة ليست نفسها في كل موقع. Markdown ليس HTML وليس برنامجاً.

العلامة تقول دور النص. السطر الفارغ يفصل كتلة جديدة. البرنامج الذي يحوّل يخرج من هذا HTML.

• # عنوان
• الشرطة بند قائمة
• نجمتان تجعلان النص غليظاً
• الملف نفسه لا يفتح صفحة

هذا يكتب عنواناً وقائمة. لا يرسم الصفحة بنفسه.

# Qeyd

- birinci
- ikinci

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