ما هو "مارك داون"؟ دليل بسيط للمبتدئين

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

ما هو "مارك داون"؟

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

على سبيل المثال:

# This is a Heading

This is a **bold word** and this is *italic*.

- List item one
- List item two

تصنيف مثل:

هذا عنوان

هذا هو كلمة جريئة وهذا هو italic.

• البند الأول من القائمة
• البند الثاني من القائمة

التنسيق يعيش في النص نفسه لا يوجد XML مخفي، لا يوجد تنسيق ثنائي، لا يوجد ترميز خاص.

لماذا تم إنشاء Markdown؟

قبل Markdown، واجه مؤلفو المواقع الإلكترونية خيارًا: الكتابة في HTML الخام (مُملة وذات عرضة للخطأ) أو استخدام محرر WYSIWYG الذي ينتج رمزًا فوضويًا. جون غروبير صمم Markdown ليكون:

1. قابل للقراءة كما هو حتى بدون تقديم، **bold** يقرأ بوضوح كما التأكيد
2. يمكن أن يكتبها أي شخص لا برنامج خاص، مجرد محرر نص
3. قابل للتحويل إلى HTML تنسيق الناتج الأساسي

تركز المواصفات الأصلية على إنتاج HTML النظيف. لكن Markdown انتشر منذ ذلك الحين إلى عشرات المنصات وتنسيقات الإنتاج.

أين يتم استخدام Markdown؟

Markdown هو في كل مكان في التكنولوجيا:

إذا كنت تكتب أي محتوى فني، كنت تقريبا بالتأكيد واجهت Markdown.

Markdown مقابل Word: الاختلافات الرئيسية

إذا كان لديك Word المستندات التي تريد تحويلها إلى Markdown، WordToMD يتعامل مع هذا على الفور لا تسجيل، لا تحميل.

Markdown النحو الأساسي

إليك العناصر الأكثر شيوعاً:

العناوين

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

انظر Markdown دليل العناوين للإشارة الكاملة.

التأكيد

**Bold text**
*Italic text*
~~Strikethrough~~

قوائم

- Unordered item
- Another item
  - Nested item

1. First
2. Second
3. Third

الروابط

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

صور

![Alt text](image.png)

الرمز

Inline: `code snippet`

Block:
```python
print("Hello, Markdown!")

See [Markdown Code Blocks Guide](/blog/markdown-code-blocks-guide).

### Tables

```markdown
| Name | Role |
|---|---|
| Alice | Developer |
| Bob | Designer |

انظر Markdown الجداول: دليل كامل.

الحصص الجماعية

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

Markdown النكهات

Markdown ليس معيار واحد هناك عدة متغيرات:

• CommonMark مواصفات صارمة وغير واضحة
• GitHub ذو نكهة Markdown (GFM) CommonMark + الجداول، قوائم المهام، التمرير، الروابط التلقائية
• التخفيض المتعدد يضيف ملاحظات قاعدة، اقتباسات، البيانات الوصفية
• (بـ (بـ (بـ (بـ (بـ أكثر الميزات غنية، تستخدم بواسطة محول Pandoc

معظم المنصات تدعم CommonMark على الأقل. GitHub، Obsidian، و GitBook تستخدم GFM. للمرجع الكامل، انظر Markdown النحو ورقة مرجعية سريعة.

كيفية كتابة Markdown

أنت لا تحتاج إلى برامج خاصة. الخيارات تشمل:

• رمز VS محرر مجاني وقوي مع عرض Markdown المسبق
• Obsidian Markdown تطبيق لتدوين الملاحظات مع عرض الرسوم البيانية
• طيفورا WYSIWYG Markdown محرر
• (iA) كاتب بيئة كتابة مركزة
• أي محرر نص عادي دفتر الملاحظات, TextEdit, vim, emacs

التحويل بين Markdown وغيرها من التنسيقات

إذا كان لديك Word وثائق لتحويلها إلى Markdown، WordToMD يقوم بذلك في ثوان مجاناً تماماً، بدون تحميل ملفات.

للعكس (Markdown إلى Word أو PDF) ، أدوات مثل Pandoc تتعامل مع هذا التحويل. انظر Pandoc Word إلى Markdown لتعليمات التثبيت

FAQ

هل Markdown لغة برمجة؟ لا، لا. Markdown هي لغة ترميز تصف التنسيق، وليس المنطق أو الحساب.

هل يمكنني استخدام Markdown في Microsoft Word؟ Word لا يعرض Markdown بشكل طبيعي ، ولكن هناك Word إضافات تضيف دعم Markdown. بدلاً من ذلك، تحويل Word إلى Markdown مع WordToMD واستخدم محرر Markdown

هل Markdown جيد للمستندات الطويلة؟ نعم، مع هيكل التوجيه الجيد. تستفيد الوثائق الطويلة جداً من التقسيم إلى ملفات متعددة (كما هو الحال في خزائن GitBook أو Obsidian).

ما هو تمديد الملف الذي يستخدمه Markdown؟ .md هو المعيار. .markdown صحيح أيضاً بعض المنصات تستخدم .mdx لـ Markdown مع مكونات JSX (React).

النتيجة

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