طريقة استخدام أداة محرر Markdown
- اكتباكتب Markdown في اللوحة اليسرى أو افتح ملف .md. تتحدّث المعاينة على اليمين أثناء الكتابة.
- نسّقاستخدم شريط الأدوات للعناوين والخط العريض والروابط والقوائم والجداول والكود، أو الاختصارات Ctrl+B وCtrl+I وCtrl+K.
- اختر العرضاعمل بلوحتين جنبًا إلى جنب، أو انتقل إلى «كتابة» أو «معاينة» لاستخدام العرض الكامل.
- صدّرنزّل ملف Markdown أو صفحة HTML جاهزة للنشر أو PDF، أو انسخ كود HTML.
المزايا
- معاينة مباشرةشاهد العناوين والقوائم والجداول والاقتباسات وكتل الكود منسّقة أثناء الكتابة.
- GitHub Flavored Markdownتعمل الجداول وقوائم المهام والخط المشطوب وكتل الكود كما في GitHub.
- تحرير ذكيتستمر القوائم والاقتباسات عند الضغط على Enter، ويزيح Tab الأسطر المحددة.
- حفظ تلقائيتبقى مسودتك في هذا المتصفح، فلا تفقد عملك عند إعادة التحميل أو إغلاق علامة التبويب.
ما هو Markdown؟
Markdown طريقة بسيطة لتنسيق النص باستخدام رموز عادية: السطر الذي يبدأ بـ # يصبح عنوانًا، و**النص** يصبح عريضًا، والسطر الذي يبدأ بـ - يصبح عنصرًا في قائمة. يُستخدم في ملفات README والتوثيق وتطبيقات الملاحظات والمنتديات والمواقع الثابتة، لأنه سريع في الكتابة وسهل القراءة حتى قبل تنسيقه.
دليل سريع لـ Markdown
| تكتب | تحصل على |
|---|---|
| # عنوان، ## عنوان | عنوان من المستوى الأول والثاني |
| **عريض**، *مائل*، ~~مشطوب~~ | عريض، مائل، مشطوب |
| [نص](https://example.com) | رابط |
| - عنصر أو 1. عنصر | قائمة نقطية أو مرقمة |
| - [ ] مهمة | مربع اختيار |
| > اقتباس | كتلة اقتباس |
| `شيفرة` و ``` أسوار | شيفرة داخل السطر وكتل شيفرة |
| --- | خط أفقي |
يعمل GitHub Flavored Markdown: الجداول وقوائم المهام والنص المشطوب وكتل الشيفرة كما في GitHub. وتعرض المعاينة الحية العناوين والقوائم والجداول والاقتباسات والشيفرة أثناء الكتابة. وعند الضغط على Enter تستمر القوائم والاقتباسات تلقائيًا، ويزيح Tab الأسطر المحددة.
الكتابة بالعربية في Markdown
رموز Markdown نفسها لا تتغير مع العربية: # و** و- تعمل كما هي في بداية السطر. لكن خلط الكلمات الإنجليزية والأرقام والشيفرة داخل جملة عربية قد يجعل علامات الترقيم تظهر في غير مكانها في المحرر، لأن اتجاه السطر يتحدد بأول حرف فيه. نصائح عملية:
- ابدأ السطر بكلمة عربية قدر الإمكان، فيأخذ السطر اتجاه اليمين إلى اليسار.
- ضع أسماء الملفات والأوامر بين علامتي ` لتظهر ككتلة مستقلة لا تختلط بالنص.
- عند نشر المحتوى في موقع، أضف dir="rtl" إلى الحاوية أو استخدم قالبًا يدعم العربية.
أين يُحفظ عملك
يعمل المحرر في متصفحك. تُحفظ المسودة تلقائيًا في التخزين المحلي لهذا المتصفح، فلا تفقد شيئًا عند إعادة التحميل أو إغلاق علامة التبويب. لا يُرفع شيء إلا إذا اخترت «تنزيل PDF»: عندها تُرسل الصفحة المنسقة إلى محرك PDF لدينا وتُحذف فورًا. وإذا استخدمت «الطباعة» واخترت «حفظ بتنسيق PDF»، فيُنشأ ملف PDF بالكامل على جهازك. تصدير HTML صفحة كاملة بأنماط مقروءة، وملف PDF يأتي بأرقام صفحات. ويُنقّى HTML الموجود داخل Markdown في المعاينة، فلا يستطيع المحتوى الملصوق تشغيل سكربتات.
لتحويل ملفات موجودة لديك استخدم Markdown إلى HTML، أو بالاتجاه المعاكس HTML إلى Markdown.
من يستخدم Markdown؟
- المطورون: يكتبون ملفات README والتوثيق ووصف طلبات الدمج. تعرض GitHub وGitLab وBitbucket ملفات Markdown.
- المدونون والكتّاب: يكتبون دون صراع مع محرر مرئي. وتنشر Jekyll وHugo وGhost ومنصات كثيرة Markdown مباشرة.
- الطلاب: يدوّنون ملاحظاتهم في تطبيقات مثل Obsidian وNotion وJoplin التي تعتمد Markdown.
- الفرق: تنسق الرسائل في Slack وDiscord وReddit بالرموز نفسها.
نصائح للكتابة
- اترك سطرًا فارغًا بين الفقرات، وقبل القوائم والعناوين وكتل الشيفرة وبعدها. معظم مشكلات التنسيق سببها سطر فارغ ناقص.
- استخدم عنوان # واحدًا لاسم المستند و## للأقسام. التسلسل الواضح للعناوين يعطي نتيجة أفضل أيضًا عند تحويل النص إلى صفحة ويب.
- اكتب اسم اللغة بعد علامات ``` الثلاث، مثل ```python، لتلوّن المواقع الداعمة الشيفرة بشكل صحيح.
- ملف .md نص عادي: يفتح في أي محرر وعلى أي جهاز، وسيبقى مقروءًا بعد عقود.