إليكم مراجعة قصيرة لـ Markdown وصيغته الأساسية، لمن لم يتعرّف عليه من قبل. رأينا سابقًا ملفات مثل CLAUDE.md وMEMORY.md. هذه ملفات Markdown: نص عادي مع رموز قليلة للتنسيق. سنرى ما يمكن وضعه فيها، وكيف نعدّلها ونعرضها. ينتشر Markdown في البرمجة بالوكلاء لأن الناس يستطيعون قراءة نصه، ويعدّله الوكلاء بأدوات الملفات نفسها التي يستخدمونها للكود.
لنبدأ بمثال صغير. على اليسار النص المصدري لملف اسمه notes.md، وعلى اليمين شكله كما يعرضه عارض Markdown. علامة # تليها مسافة تجعل السطر عنوانًا. وعلامتا ## تجعلانه عنوانًا فرعيًا. شرطة ثم مسافة تُنشئ بندًا في قائمة نقطية، والأرقام المتبوعة بنقطة تُنشئ قائمة مرقّمة. الجمل العادية تصبح فقرات، تفصل بينها أسطر فارغة. تبقى العلامات سهلة القراءة في المصدر، ويحوّله العارض إلى المستند المنسّق بجانبه.
علامتا نجمة على كل جانب من النص تجعلانه غامقًا. وعلامات الـ backtick تميّز الكود داخل الجملة. في الرابط يُكتب النص بين قوسين مربعين، وعنوان URL بين قوسين هلاليين. يمكن أن يتضمّن Markdown أيضًا صورًا وكتلًا من الكود. ويمكنكم البحث عن الصيغة عندما تحتاجونها.
في VS Code، افتحوا ملف Markdown. اضغطوا Control وShift وP لفتح Command Palette، أو Command وShift وP على جهاز Mac. ثم اختاروا Markdown: Open Preview to the Side. الآن يمكنكم تعديل المصدر وأنتم تقرؤون المعاينة المنسّقة بجانبه.
إذا غيّرنا نص هذا البند إلى Add search by title، تُحدَّث المعاينة. هذان عرضان للملف نفسه. عدّلوا النص على اليسار، واقرؤوا النسخة المنسّقة على اليمين، واحفظوا تغييراتكم كالمعتاد.
تستطيع أداة تحويل أن تحوّل Markdown إلى HTML لصفحة ويب، أو إلى صيغ مثل PDF وWord. وتوفّر أدوات مثل Pandoc هذه التحويلات. تحتفظون بالنص القابل للتعديل، وتولّدون مستندًا منسّقًا عند الحاجة.
ويدعم بعض برامج العرض أيضًا إضافات مثل Mermaid، الذي يحوّل وصفًا نصيًا إلى مخطط. هذه الكتلة تصف ثلاث خطوات: Request وEdit وReview، والعارض يرسم المربعات والأسهم. ويختلف دعم Mermaid من عارض إلى آخر. يرسم GitHub المخطط، أما معاينة VS Code فتحتاج إلى إضافة.
هذا يكفي للبداية. يمكنكم تنظيم الملاحظات والتعليمات في ملف Markdown، ومعاينتها بسهولة، والعمل مع وكيلكم على النص المقروء نفسه.