دليل Markdown المختصر: الصياغة مع أمثلة (GFM)

الإجابة السريعة

# Heading للعنوان، و**bold** للخط العريض، و*italic* للمائل، و[link](url) للرابط، و![image](url) للصورة، و- item للقائمة، و1. item للترقيم، و> quote للاقتباس، و`code` للكود، و``` لكتل الكود. وتستخدم الجداول الخطوط العمودية: | a | b |. جرّب أي شيء في محرر Markdown المباشر لترى النتيجة فورًا.

محرر Markdown إلى HTML مع نص Markdown على جانب ومعاينة منسقة مباشرة على الجانب الآخر — نص Markdown على جانب، والمعاينة المباشرة على الجانب الآخر. لقطة شاشة لأداتنا المجانية: تحويل Markdown إلى HTML.

ما Markdown؟

Markdown لغة ترميز خفيفة أنشأها جون غروبر عام 2004. وهدفها بسيط: نص سهل القراءة كما هو، ويتحول إلى HTML بشكل نظيف. وهي اليوم المعيار لملفات README والتوثيق ومنتديات المطورين وتطبيقات الملاحظات مثل Obsidian وتطبيقات المحادثة مثل Slack وDiscord وكثير من منصات التدوين.

واللهجة الأكثر شيوعًا هي GitHub Flavored Markdown ‏(GFM)، التي تضيف إلى الصياغة الأصلية الجداول وقوائم المهام والنص المشطوب والروابط التلقائية.

العناوين

# Heading 1
## Heading 2
### Heading 3
#### Heading 4

استخدم عنوانًا واحدًا بعلامة # لكل مستند (العنوان الرئيسي)، وحافظ على ترتيب المستويات. وضع دائمًا مسافة بعد #.

التأكيد

Markdown	النتيجة
`عريض`	عريض
`مائل` أو `_مائل_`	مائل
`*عريض مائل*`	*عريض مائل*
`~~مشطوب~~`	~~مشطوب~~ (GFM)
`كود ضمن السطر`	`كود ضمن السطر`

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

[Link text](https://example.com)
[Link with title](https://example.com "Hover text")
<https://example.com>

![Alt text describing the image](image.png)

[Reference link][docs]
[docs]: https://example.com/docs

اكتب نصًا بديلًا معبّرًا للصور، فقارئات الشاشة تقرؤه بصوت عالٍ، وهو يساعد محركات البحث على فهم الصورة.

القوائم

- Bullet item
- Another item
  - Nested item (indent 2 spaces)

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

- [x] Finished task
- [ ] Open task

المسافة البادئة بمسافتين تُنشئ عنصرًا متداخلًا. وقوائم المهام (- [ ]) جزء من GFM، وتظهر كمربعات اختيار على GitHub وفي كثير من المحررات.

الاقتباسات

> This is a quote.
>
> It can span several paragraphs.

كتل الكود

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

أحِط الكود بثلاث علامات backtick وأضف اسم اللغة (js أو python أو bash أو json…) حتى تتمكن أدوات إبراز الصياغة من تلوينه.

الجداول

| Tool        | Category | Price |
| :---------- | :------: | ----: |
| Summarizer  | Text     | Free  |
| OCR         | Images   | Free  |

تحدد النقطتان في سطر الفصل المحاذاة: :--- لليسار، و:---: للوسط، و---: لليمين. ولا يلزم أن تكون الأعمدة متراصفة في المصدر، فذلك يسهّل القراءة فقط.

الخطوط الفاصلة وفواصل الأسطر

Three dashes on their own line make a divider:

---

End a line with two spaces (or a backslash)\
to force a line break inside a paragraph.

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

تهريب الرموز الخاصة

لإظهار رمز تفسّره Markdown عادةً، ضع قبله شرطة مائلة عكسية: \*not italic\* و\#not a heading و\[not a link\].

Markdown والنصوص العربية

تعمل صياغة Markdown مع العربية دون مشكلة، لكن اتجاه النص يعتمد على المنصة. فإذا ظهر نصك العربي من اليسار إلى اليمين، فيمكنك في كثير من المنصات إحاطته بوسم HTML مثل <div dir="rtl">…</div>، أو ضبط اتجاه الصفحة كلها في ملف HTML المُصدَّر بالسمة dir="rtl".

جرّب مباشرة وصدّر إلى HTML

افتح محرر Markdown إلى HTML المجاني.
اكتب Markdown، أو استخدم شريط الأدوات للعناوين والخط العريض والروابط والقوائم والجداول والكود.
شاهد المعاينة تتحدّث أثناء الكتابة، وانتقل إلى تبويب HTML لترى الكود المُولَّد.
انسخ HTML، أو حمّل صفحة ‎.html كاملة، أو احفظ ملف ‎.md.

تُحفظ مسودتك تلقائيًا في متصفحك، ولا يُرفع أي شيء.

جرّبها مجانًا: تحويل Markdown إلى HTML

اكتب بصيغة Markdown مع معاينة مباشرة وصدّر HTML نظيفًا. تعمل في متصفحك، دون تسجيل.

افتح الأداة

نصائح Markdown

اترك أسطرًا فارغة حول العناوين والقوائم وكتل الكود والجداول.
كن متّسقًا: اختر - أو * للنقاط والتزم به.
استخدم روابط نسبية في المستودعات ([Setup](docs/setup.md)) لتعمل في كل فرع.
عاين قبل النشر. تختلف المنصات قليلًا في الإضافات التي تدعمها.
استخدم HTML عند الحاجة. تقبل معظم معالجات Markdown وسوم HTML لما لا تستطيعه Markdown، مثل <kbd> أو <details>، وإن كانت بعض المنصات تحذفها لأسباب أمنية.

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

ما الفرق بين Markdown وGitHub Flavored Markdown؟

GFM توسعة لـ Markdown القياسية (CommonMark) تضيف الجداول وقوائم المهام والنص المشطوب والروابط التلقائية.

كيف أضع خطًا تحت النص في Markdown؟

لا توجد في Markdown صياغة للتسطير، لأن النص المسطّر يشبه الرابط. وإن احتجت إليه فعلًا، فاستخدم HTML: <u>نص</u>.

كيف أضيف فاصل أسطر دون فقرة جديدة؟

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

هل HTML المُصدَّر آمن للاستخدام في موقعي؟

نعم. HTML المُصدَّر ترميز دلالي نظيف دون أنماط مضمّنة، والمعاينة منقّاة لمنع السكربتات.

الخلاصة

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

وجدت معلومة قديمة أو غير واضحة؟ راسل contact@ultratoolsai.com وسنصححها.

دليل Markdown المختصر: كل الصياغة التي تحتاجها مع أمثلة