محرر Markdown

مقدمة

يمنحك محرر Markdown في Ali Hub مساحة واحدة لكتابة نص Markdown ومشاهدة طريقة عرضه. اكتب المصدر أو الصقه في المحرر، ثم استخدم المعاينة لفحص العناوين والتنسيق والقوائم والروابط والاقتباسات والتعليمات البرمجية وغيرها من البنى الشائعة قبل نقل النص إلى توثيق أو ملف README أو ملاحظة أو نظام نشر. تفيد المعاينة لأن مصدر Markdown مختصر بطبيعته؛ فعلامة النجمة أو علامة المربع أو السطر الفارغ يمكن أن تغيّر طريقة ظهور المستند للقارئ.

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

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

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

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

ماذا يفعل محرر Markdown؟

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

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

قد يفسر المحرر الصيغة المدعومة لعرضها، لكنه يفترض أن يبقي المصدر نصًا قابلًا للتحرير. وهو ليس برنامج معالجة نصوص كاملًا، ولا يحوّل HTML العشوائي أو النص المنسق أو الملف المرفق تلقائيًا إلى مستند Markdown كامل.

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

قد تتطلب العربية عناية إضافية عند مزجها مع أسماء أو أوامر لاتينية. راجع اتجاه السطر، ومكان علامات الترقيم، والمسافات حول الرابط أو الكود. إذا كان المستند سيُقرأ على الهاتف، عاين الأسطر الطويلة والعناوين المتتابعة، لأن العرض الضيق قد يغيّر الراحة البصرية حتى عندما تكون صيغة Markdown صحيحة.

طريقة الاستخدام

1. اكتب مصدر Markdown أو الصقه في المحرر، وحافظ على العناوين والأسطر الفارغة والمسافات البادئة عندما تكون مهمة.
2. اقرأ المعاينة وابحث عن التسلسل المقصود للعناوين والتنسيق والقوائم والروابط والاقتباسات وكتل التعليمات البرمجية.
3. ارجع إلى المصدر لتصحيح العلامات أو المسافات، ثم عاين الجزء الذي تغيّر مرة أخرى.
4. انسخ مصدر Markdown بعد مراجعته إلى وجهته، وافحص العرض النهائي هناك إذا كان النظام يستخدم قواعد Markdown مختلفة.

طريقة المعاينة

أمثلة

قراءة الناتج

قارن المعاينة ببنية المستند التي تريدها. ينبغي أن يظهر العنوان عنوانًا، وأن تبقى عناصر القائمة مجمعة، وأن تشير الروابط إلى الوجهة المقصودة، وأن تبقى التعليمات البرمجية واضحة ولا تختلط مع النثر.

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

أخطاء شائعة

نسيان السطر الفارغ الذي يفصل العنوان أو القائمة عن الفقرة التالية.

وضع وجهة الرابط خارج الأقواس أو استخدام علامات ترقيم ذكية تغيّر علامات Markdown.

افتراض أن كل محركات Markdown الخارجية تدعم الجداول أو HTML أو الوسائط أو الإضافات نفسها التي تظهر في المعاينة المحلية.

الحدود

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

لا تفحص الحقائق ولا الإملاء ولا تعيد الصياغة ولا تترجم ولا تصلح رابطًا معطلًا أو أمرًا برمجيًا تلقائيًا. راجع المحتوى والوجهات الحساسة يدويًا.

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

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

إذا كان Markdown يحتوي على HTML خام أو صورة أو رابط خارجي، تعامل معه بحذر. راجع المصدر قبل مشاركته، وتأكد من أن العناوين لا تحتوي على معلومات سرية وأن الروابط تقود إلى النطاق المقصود. المعالج يعرض النص وفق قواعده ولا يمنح موافقة أمنية أو قانونية على المحتوى.

الأسئلة الشائعة