دليل Markdown الشامل للكتّاب والمطورين العرب

إذا كنت تكتب توثيقًا برمجيًا، أو تدير مدونة، أو تُسجّل ملاحظاتك في أدوات مثل Obsidian أو Notion، فأنت على الأرجح تتعامل مع Markdown يوميًا — سواء أدركت ذلك أم لا. يمكنك استخدام محرر Markdown في BrowseryTools — مجانية تمامًا، بدون تسجيل، وتعمل في متصفحك — للكتابة والمعاينة الفورية لأي نص Markdown.

في هذا الدليل، نشرح ما هو Markdown، ولماذا أصبح معيارًا في كتابة المحتوى التقني والمدونات، مع دليل شامل للصيغ الأساسية واستخدامه مع اللغة العربية.

ما هو Markdown؟

Markdown لغة ترميز خفيفة (Lightweight Markup Language) أنشأها John Gruber عام 2004 بالتعاون مع Aaron Swartz. الفكرة الأساسية بسيطة: كتابة نص عادي باستخدام رموز بسيطة يمكن تحويله تلقائيًا إلى HTML منسّق. بدلًا من كتابة <strong>نص عريض</strong>، تكتب ببساطة **نص عريض**.

الهدف الذي حدده Gruber كان واضحًا: أن يكون النص القابل للقراءة البشرية قابلًا للقراءة كنص عادي دون أن يبدو مليئًا بوسوم HTML. هذا يجعل ملفات Markdown قابلةً للقراءة حتى في أبسط محرر نصوص.

لماذا أصبح Markdown المعيار؟

لم ينتشر Markdown بقرار من لجنة أو معيار رسمي — انتشر لأنه حل مشكلة حقيقية بأناقة بالغة. المطورون احتاجوا لكتابة توثيق يبقى قابلًا للقراءة كنص عادي ويُعرض كـ HTML على الويب في آنٍ واحد. الكتّاب احتاجوا لتنسيق بسيط لا يشتت انتباههم عن المحتوى. GitHub اعتمده لقراءة ملفات README، ثم تبعه Notion وObsidian وReddit وStackOverflow وغيرها.

النتيجة: أي شخص يتعلم Markdown اليوم يستثمر تلك المعرفة في عشرات المنصات فورًا.

الصيغ الأساسية التي تحتاجها يوميًا

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

• القوائم غير المرقّمة — شرطة أو نجمة في بداية كل بند
• القوائم المرقّمة — رقم يتبعه نقطة في بداية كل بند
• الكود المضمّن — النص بين علامتَي backtick
• كتلة الكود — ثلاث علامات backtick تفتح الكتلة وثلاث أخرى تغلقها، مع اختياري ذكر لغة البرمجة
• الاقتباس — رمز > في بداية السطر
• الخط الأفقي الفاصل — ثلاث شرطات أو ثلاث نجمات في سطر مستقل
• الجداول — أعمدة تُفصل بالشرطة العمودية | مع سطر فاصل بين الرأس والبيانات

استخدام Markdown مع اللغة العربية

اللغة العربية تكتب من اليمين إلى اليسار (RTL)، وهذا يخلق بعض التحديات العملية عند الكتابة بـ Markdown. معظم المحررات الحديثة كـ Obsidian وNotion وVSCode تدعم النصوص ثنائية الاتجاه بشكل جيد، لكن ثمة نقاط يجب معرفتها:

• رموز التنسيق تبقى في مكانها — علامات # والنجوم والشرطات تُكتب في اتجاهها الطبيعي (LTR) حتى في النصوص العربية. فمثلًا، العنوان يُكتب # عنوان الصفحةوالهاش يسبق النص.
• HTML مضمّن للتحكم الكامل — يمكن استخدام dir="rtl" على عنصر HTML مضمّن داخل Markdown للتحكم الدقيق في اتجاه مقطع معين.
• المحررات المتخصصة أفضل — محرر BrowseryTools يعرض الـ Markdown العربي بشكل صحيح مع معاينة فورية.

أين يُستخدم Markdown؟

انتشار Markdown اليوم يجعله حاضرًا في كل مكان تقريبًا يمسّ المحتوى الرقمي:

• GitHub وGitLab — ملفات README، توثيق المشاريع، تعليقات pull requests
• Obsidian — نظام ملاحظات شخصي كامل مبني على Markdown
• Notion — يدعم استيراد وتصدير Markdown لمعظم الكتل
• Jekyll وHugo وNext.js — مولدات المواقع الساكنة تُحوّل Markdown إلى صفحات HTML
• Reddit وStack Overflow وDiscord — يدعمون نسخًا من Markdown لتنسيق التعليقات
• Bear وIA Writer وUlysses — تطبيقات كتابة احترافية تعتمد Markdown أساسًا

تحويل Markdown إلى HTML

عندما يُعالج تطبيق ملف Markdown، يمر بخطوة تحويل: كل رموز التنسيق تُترجم إلى وسوم HTML مقابلة. الهاش يصبح <h1>، والنجوم المزدوجة تصبح <strong>، القائمة تصبح <ul> و<li>، وهكذا. هذه العملية تؤديها مكتبات مثل marked.js وremark وpandoc.

محرر BrowseryTools يُجري هذا التحويل في الوقت الفعلي في متصفحك: تكتب على اليسار وترى النتيجة HTML المُنسَّقة على اليمين فورًا. يمكنك نسخ HTML الناتج مباشرةً للاستخدام في أي موقع أو تطبيق.

ابدأ بـ Markdown اليوم

تعلّم Markdown استثمار بعيد المدى. لا يتغير بين المنصات، ولا يتقادم مع الزمن، ولا يحتاج إنترنتًا. ملفاتك تبقى نصًا عاديًا قابلًا للقراءة حتى بعد عشرين سنة بأي محرر نصوص. افتح محرر Markdown في BrowseryTools وجرّب كتابة ملاحظتك التالية به — ستندهش كم هو بسيط ومحرر في آنٍ واحد.