Menu
Coddy logo textTools
العربية

محرر Markdown

اكتب Markdown مع معاينة مقسّمة مباشرة.

Last updated

العرض
Markdownاكتب Markdown للبدء
المعاينة
يظهر Markdown المعروض هنا — جداول وقوائم مهام وكود والمزيد.

ما هو محرر Markdown؟

محرر Markdown هو بيئة كتابة بشاشة مقسومة: تكتب نص Markdown العادي في جهة، وتظهر المعاينة المُصيَّرة مباشرة في الجهة الأخرى وتتحدّث لحظيًا أثناء الكتابة. هذه هي الصيغة التي تشغّل ملفات README على GitHub، وبوابات التوثيق، ومولّدات المواقع الثابتة، ومنصات التدوين، وتطبيقات الملاحظات مثل Obsidian، وحتى أدوات الدردشة كـ Discord و Slack.

الفكرة الأساسية من Markdown هي أن يكون النص واضحًا ومقروءًا كنص عادي، ثم يتحوّل إلى HTML منظّم عند العرض. تقضي وقتًا أقل في العبث بأشرطة أدوات التنسيق، ووقتًا أكثر في الكتابة الفعلية — ولهذا بالضبط يفضّله الكتّاب التقنيون والمطورون.

معظم محررات Markdown الحديثة تدعم *GitHub-Flavored Markdown* (GFM)، الذي يضيف الجداول وقوائم المهام وكتل الأكواد المُحاطة بسياج مع تلميح اللغة، والروابط التلقائية والشطب، فوق مواصفة CommonMark الأصلية.

ما الذي ستتعلّمه أثناء استخدام محرر Markdown

  • Markdown هو نص عادي — مقروء داخل المحرر *وفي نفس الوقت* قابل للتصيير كـ HTML، بدون أشرطة أدوات أو تنسيق مخفي.
  • العناوين والقوائم والروابط والتأكيد تغطي 90% من الكتابة المعتادة. والجداول وكتل الأكواد تغطي معظم الـ 10% المتبقية.
  • كتل الأكواد المُسيّجة مع تلميح اللغة ( js , python ) تُفعّل تلوين الصياغة في كثير من المُصيِّرات.

كيفية استخدام محرر Markdown خطوة بخطوة

  1. ابدأ بالكتابة في اللوحة اليمنى

    استخدم # للعناوين، و * أو _ للتأكيد، و - للقوائم. اللوحة المقابلة ستتحدّث أثناء الكتابة.

  2. أضف بنية للنص

    أدرج عناوين وكتل أكواد وجداول لتنظيم المستند. معظم المحررات تدعم اختصارات لوحة المفاتيح (Ctrl+B, Ctrl+I) للتنسيقات الشائعة.

  3. عاين HTML المُصيَّر

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

  4. انسخ أو نزّل

    انسخ مصدر Markdown إلى ملف README الخاص بك، أو انسخ HTML إلى بريد إلكتروني أو نظام إدارة محتوى أو أي مكان لا يفهم Markdown.

ورقة مرجعية لصياغة Markdown

الـ 80% من Markdown التي ستستخدمها يوميًا. أي شيء آخر تجده ببحث سريع. المواصفات: CommonMark و GitHub-Flavored Markdown.

العنصرMarkdownيُعرض كـ
عنوان رئيسي 1# Titleعنوان من المستوى الأعلى
عنوان 2## Sectionعنوان قسم
عريض**strong****strong**
مائل*emphasis* أو _emphasis_*emphasis*
كود مضمَّن code code
كتلة كودأحط الكود بسياج من ثلاث علامات backtick مع تلميح لغة اختياريكتلة بتلوين صياغة
رابط`label`رابط قابل للنقر
صورة`!alt`صورة مضمّنة
قائمة- itemقائمة نقطية
قائمة مرقّمة1. itemقائمة مرتّبة
قائمة مهام (GFM)- [x] doneمربع اختيار مُحدَّد
جدول (GFM)| a | b |\n|---|---|\n| 1 | 2 |جدول من عمودين
اقتباس> quoteاقتباس بإزاحة

أمثلة Markdown لتجربتها

افتتاحية README نموذجية

المصدر
# Project Name
A short description in one or two sentences.
## Install
```bashnpm install project-name```
## Quick start
- Step 1- Step 2- Step 3

عنوان، فقرة، أمر تثبيت داخل كتلة كود مُسيّجة، وقائمة نقطية — هذا هو العمود الفقري لأي ملف README جيد.

جداول (بنكهة GitHub)

المصدر
| Feature | Free | Pro ||---------|:----:|:---:|| Editor  |  ✓   |  ✓  || Export  |      |  ✓  |

الأنابيب (|) تفصل بين الأعمدة. سطر الشرطات يحاذي الأعمدة، وعلامات : تحدّد المحاذاة (يسار، وسط، يمين). جداول GFM لا تحتاج عرضًا دقيقًا للأعمدة — البنية وحدها هي ما يهم.

قائمة مهام

المصدر
- [x] Draft the post- [x] Add screenshots- [ ] Publish

يعرض GitHub هذه القوائم كمربعات اختيار تفاعلية داخل الـ issues والـ PRs. مفيدة لقوائم المراجعة داخل المستند ولتتبّع المهام الخفيف.

أخطاء شائعة في Markdown

  • نسيان وضع أسطر فارغة قبل وبعد القوائم والجداول وكتل الأكواد. معظم المُصيِّرات تحتاج إلى سطر فارغ لبدء كتلة جديدة.
  • خلط Tab والمسافات داخل القائمة الواحدة — بعض المُصيِّرات ستكسر الإزاحة بصمت دون تنبيه.
  • وضع HTML خام داخل كتلة كود وتوقّع أن يُصيَّر. كتل الأكواد *حرفية* — هذه هي وظيفتها أصلًا.

أسئلة شائعة عن محرر Markdown

ما هو Markdown؟
Markdown هي لغة وسم خفيفة تحوّل صياغة نصية بسيطة (# heading, **bold**, `link`) إلى HTML منسّق. مصمَّمة لتبدو مقروءة وواضحة حتى في صورتها المصدرية.
كيف أحوّل Markdown إلى HTML؟
ألصق نص Markdown في محرر Markdown وانسخ HTML المُصيَّر، أو شغّل محوّلًا مثل marked أو markdown-it أو pandoc. معظم مولّدات المواقع الثابتة تقوم بهذا تلقائيًا وقت البناء.
ما الفرق بين Markdown و GitHub-Flavored Markdown؟
يضيف GitHub-Flavored Markdown (GFM) الجداول وكتل الأكواد المُسيّجة مع تلميحات اللغة، وقوائم المهام، والروابط التلقائية، والشطب — فوق Markdown القياسي. وهي اللهجة المستخدمة في GitHub و GitLab وكثير من منصات التوثيق.
هل يمكنني استخدام HTML داخل Markdown؟
نعم — معظم المُصيِّرات تمرّر HTML الخام كما هو. هذا مفيد لتضمين أشياء لا يدعمها Markdown أصلًا (تخطيطات مخصصة، وسوم فيديو)، لكنه يربط مستندك بمخرج HTML.
هل محرر Markdown يحافظ على الخصوصية؟
نعم. محرر Coddy يُصيِّر Markdown بالكامل داخل متصفّحك — نصّك لا يُرفع إلى أي خادم.

أدوات مطورين أخرى

مختبر Regex

اختبر التعابير النمطية مع تمييز متحرك للمطابقات.

مُرمِّز / فاك ترميز Base64

رمّز أو فكّ ترميز سلاسل وملفات Base64 فورًا.

مُرمِّز / فاك ترميز URL

رمّز وفك ترميز مكونات URL بأمان.

تعلّم البرمجة مع Coddy

ابدأ الآن