أساسيات Markdown: دليل المبتدئين الشامل

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

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

العناوين

أنشئ العناوين ببدء السطر برموز المربع (#). عدد الرموز يحدد مستوى العنوان:

# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6

ضع دائماً مسافة بعد رموز المربع. استخدم مستويات العناوين بشكل هرمي — ابدأ بـ H1 للعنوان الرئيسي، ثم H2 للأقسام الرئيسية، وH3 للأقسام الفرعية، وهكذا.

تنسيق النص

يسهّل Markdown التأكيد على النص:

• غامق - أحط النص بنجمتين مزدوجتين: **bold text**
• مائل - أحط النص بنجمة واحدة: *italic text*
• غامق ومائل - اجمعهما: ***bold and italic***
• يتوسطه خط - أحط بتيلدا مزدوجة: ~~strikethrough~~
• شفرة مضمّنة - أحط بعلامات خلفية: `code`

القوائم

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

أنشئ نقاطاً بالشرطات أو النجوم أو علامات الزائد:

- First item
- Second item
- Third item

القوائم المرتبة

استخدم الأرقام متبوعة بنقاط:

1. First step
2. Second step
3. Third step

القوائم المتداخلة

أضف مسافة بادئة لإنشاء عناصر متداخلة:

- Main item
  - Sub-item
  - Another sub-item
- Another main item

الروابط والصور

الروابط

أنشئ روابط قابلة للنقر بهذه الصياغة:

[Link text](https://example.com)

مثال: [Visit Markdown2ANY](https://markdown2any.com)

الصور

تستخدم الصور صياغة مشابهة مع علامة تعجب:

![Alt text](image-url.jpg)

النص البديل يصف الصورة لأغراض إمكانية الوصول.

الاقتباسات

أنشئ نصاً مقتبساً ببدء الأسطر برمز أكبر من:

> This is a blockquote.
> It can span multiple lines.

الاقتباسات مثالية للاستشهاد بالمصادر أو تسليط الضوء على المعلومات المهمة.

الخطوط الأفقية

أنشئ فاصلاً أفقياً بثلاث شرطات أو أكثر أو نجوم أو شرطات سفلية:

---

كتل الشفرة

للشفرة متعددة الأسطر، استخدم ثلاث علامات خلفية. حدد اللغة لتمييز بناء الجملة:

```javascript
function greet(name) {
  return `Hello, ${name}!`;
}
```

هذا ينشئ كتلة شفرة منسقة مع تمييز مناسب.

الفقرات وفواصل الأسطر

أنشئ الفقرات بترك سطر فارغ بين كتل النص. لفاصل سطر داخل فقرة، أنهِ السطر بمسافتين أو استخدم <br>.

الخطوات التالية

الآن بعد معرفة الأساسيات، يمكنك:

• التدرب باستخدام أداة معاينة Markdown المباشرة
• التعرّف على ميزات Markdown المتقدمة مثل الجداول وقوائم المهام
• البدء بـتحويل Markdown إلى صيغ أخرى