الكتابة الفعّالة باستخدام Markdown

إذا كنت تعتاد على استخدام أدوات مثل Word للكتابة، فقد تواجه السيناريوهات التالية بانتظام:

• أين زر التنسيق العريض؟ وأين زر القوائم؟ وكيف يمكن إدراج الصور بشكل صحيح؟
• بأي حجم يجب أن تكون العناوين المختلفة؟ وبأي حجم يجب أن تكون النصوص العادية؟
• عندما يتم فتح الوثيقة بإصدار آخر من Word، تصبح الأنماط غير المرغوبة.

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

الأدوات

أولاً، ستحتاج إلى محرر يدعم Markdown. أنصح باستخدام VS Code أو Typora. يمكنك الاطلاع على توجيهات تثبيت البرامج والإعداد في هذا الدليل الذي أنشأته: دليل إنتاجية VS Code - إعداد البيئة

الأوامر الشائعة

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

العناوين

لإنشاء عنوان، قم بإضافة 1-6 رمز # قبل النص العنواني. عدد المستويات يتوقف على عدد الرموز #. عمومًا، يجب ألا تزيد هيكل المقال عن 4 مستويات.

# العنوان الأعظم

## العنوان من المستوى الثاني

### العنوان من المستوى الثالث

#### العنوان من المستوى الرابع

...

تنسيق النص

قم بإضافة رموز على جانبي النص لتنسيقه:

ملاحظة: النص المائل مصمم خصيصًا للنصوص باللغة الإنجليزية. من أجل الوضوح والامتثال للقواعد، يجب تجنب استخدام النص المائل مع النصوص باللغة الصينية.

اقتباس النص

يمكنك استخدام الرمز > للاقتباس النص:

كما قالت "خليج القراصنة" في رسالة عيد الميلاد:

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

كما قالت "خليج القراص

إذا كنت بحاجة إلى عرض ملف الشيفرة المصدرية، يمكنك إضافة <code>```c title="stm32f4xx_it.c"</code> كما هو موضح أدناه:

int fputc(int ch, FILE *f)
{
    HAL_UART_Transmit(&huart1, (uint8_t*)&ch, 1, 100);
    return ch;
}

الروابط

يمكنك إنشاء روابط عن طريق وضع نص الرابط داخل الأقواس المربعة [ ] ثم وضع الرابط نفسه داخل الأقواس ( ). على سبيل المثال:

تم بناء هذا الموقع باستخدام [Docusaurus](https://v2.docusaurus.io/).

تم بناء هذا الموقع باستخدام Docusaurus.

الصور

يتم تضمين الصور بنفس الطريقة كالروابط، ولكن يجب أن تبدأ برمز !، مثل:

![](https://cdn.jsdelivr.net/gh/linyuxuanlin/Wiki-WildWolf/static/uploads/b944219198103ea09f0f02bcb830e9b.png)

ملاحظة: يمكن ترك نص العرض فارغًا داخل الأقواس [ ].

القوائم

قائمة غير مرتبة

يمكنك إنشاء قوائم غير مرتبة عن طريق إضافة - أو * قبل النص (لاحظ وجود مسافة بين الرمز والنص)، على سبيل المثال:

- عنصر القائمة
- عنصر القائمة
- عنصر القائمة

• عنصر القائمة
• عنصر القائمة
• عنصر القائمة

قائمة مرتبة

إذا كنت ترغب في إنشاء قائمة مرتبة، يجب أن تقوم بترقيم العناصر بأرقام، كما يلي:

1. عنصر القائمة الأول
2. عنصر القائمة الثاني
3. عنصر القائمة الثالث

1. عنصر القائمة الأول
2. عنصر القائمة الثاني
3. عنصر القائمة الثالث

قائمة مراجعة

إذا كنت ترغب في إنشاء قائمة مراجعة (TODO)، يمكنك استخدام الصيغة التالية:

- [x] إكمال التغييرات
- [ ] رفعها إلى GitHub
- [ ] فتح طلب سحب

• إكمال التغييرات
• رفعها إلى GitHub
• فتح طلب سحب

تضمين القوائم

إذا كنت ترغب في تضمين قوائم داخل قائمة، يمكنك استخدام مفتاح "Tab" للمسافة و "Shift" + "Tab" لإلغاء المسافة، على سبيل المثال:

1. عنصر القائمة الأول
   1. عنصر فرعي أول
   2. عنصر فرعي ثاني
      - عنصر فرعي من الدرجة الثانية
      - عنصر فرعي من الدرجة الثانية
2. عنصر القائمة الثاني

1. عنصر القائمة الأول
   1. عنصر فرعي أول
   2. عنصر فرعي ثاني - عنصر فرعي من الدرجة الثانية - عنصر فرعي من الدرجة الثانية
2. عنصر القائمة الثاني

الجداول

يمكنك إنشاء جداول باستخدام الرمز | لفصل الخلايا والرمز - لفصل العناوين عن الصفوف، كما يلي:

| الاسم      | العمر |
| ---------- | ----- |
| LearnShare | 12    |
| Mike       | 32    |

إذا كنت ترغب في محاذاة الأعمدة في الجدول، يمكنك استخدام الرمز :، على النحو التالي:

• :--- أو --- تمثل المحاذاة اليسارية.
• :--: تمثل المحاذاة الوسطية.
• ---: تمثل المحاذاة

يمكنك استخدام الرمز --- لإنشاء خط فاصل لفصل الفقرات المختلفة:

---

استخدامات متقدمة

الفقرات والتنقل

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

التصدير إلى صيغ أخرى

إذا كنت بحاجة لتصدير النص إلى صيغ مثل PDF، Word، أو صور، يمكنك استخدام Pandoc لذلك.
إذا كنت تستخدم VS Code، يمكنك استخدام إضافة Markdown PDF مباشرة لتصدير المستند إلى صيغة PDF.

الكتابة باستخدام Markdown في مقالات الجمهور

تستخدم محررات النص الغني في منصة ويشات للجمهور. يمكننا تحويل النص بتنسيق Markdown باستخدام أداة الويب MD2WeChat ولصقه في محرر ويشات للجمهور.

لمزيد من التفاصيل، يُرجى الرجوع إلى المقالة استخدام Markdown لزيادة الإنتاجية في الكتابة.

المراجع والشكر

• طريقة التحرير الخاصة بالماركداون الشخصي
• استخدام ماركداون بطريقة فعالة لتجنب مشاكل التنسيق
• younghz/Markdown (دليل ماركداون)
• Learning-Markdown (مقدمة في ماركداون)
• الكتابة الأساسية وصيغ التنسيق

عنوان النص: https://wiki-power.com/
يتم حماية هذا المقال بموجب اتفاقية CC BY-NC-SA 4.0، يُرجى ذكر المصدر عند إعادة النشر.

تمت ترجمة هذه المشاركة باستخدام ChatGPT، يرجى تزويدنا بتعليقاتكم إذا كانت هناك أي حذف أو إهمال.