محول Markdown إلى HTML
حوّل Markdown إلى HTML نظيف مع معاينة حية — انسخ أو حمّل فوراً.
ابدأ بكتابة Markdown لترى ناتج HTML.
يعمل بالكامل في متصفحك. لا يُرفع أي شيء.
انتصر ماركداون لأنه يطابق كيف يكتب الناس أصلًا. النجوم للتوكيد، والشُرط للقوائم، والأسطر الفارغة للفقرات كانت أعرافًا في بريد النص الصرف قبل عقود من إضفاء ماركداون الرسمية عليها عام 2004 — لهذا مستند ماركداون مقروء حتى لمن لم يسمع بماركداون قط. اليوم هو ركيزة ملفات README وGitHub وReddit وDiscord وتطبيقات الملاحظات ومعظم مولّدات المواقع الساكنة. يحوّل هذا المحوّل ماركداون إلى HTML نظيف فورًا في متصفحك، مع معاينة حيّة، وهو مفيد لإنتاج HTML ولتعلّم ما يولّده التركيب فعلًا معًا.
كيف يعمل المحوّل
اكتب أو الصق ماركداون في لوحة الإدخال ويظهر HTML فورًا بجانب معاينة معروضة. يتعامل المحلّل مع العناصر المعيارية — العناوين والتوكيد والقوائم والروابط والصور وكتل الكود والاقتباسات والجداول — متبعًا أعراف CommonMark مع الامتدادات التي روّجها GitHub. يحدث التحويل كليًا في متصفحك أثناء الكتابة؛ لا شيء يُرفع، ولا توجد رحلة خادم.
التركيب الأساسي
# عنوان 1 → <h1>عنوان 1</h1>
**عريض** → <strong>عريض</strong>
*مائل* → <em>مائل</em>
[نص](رابط) → <a href="رابط">نص</a>
 → <img src="صورة.png" alt="وصف">
- عنصر → <ul><li>عنصر</li></ul>
> اقتباس → <blockquote>اقتباس</blockquote>
`كود` → <code>كود</code>
```js ... ``` → <pre><code class="language-js">التقابل قريب عمدًا من واحد لواحد، لكن الحالات الحدّية هي حيث تختلف المحوّلات. فاصل سطر واحد في ماركداون لا يُنتج <br> — الفقرات تتطلّب سطرًا فارغًا، ما يفاجئ الجميع تقريبًا أول مرة. القوائم المتداخلة تعتمد على إزاحة متسقة، وخلط الجدولة بالمسافات هو السبب الكلاسيكي للتداخل المكسور. الجداول والشطب امتدادات GitHub لا ماركداون الأصلي، فتعمل هنا وعلى GitHub لكن ليس في كل محلّل CommonMark صارم.
ما يجب معرفته عن ماركداون
- 1سطر فارغ يعني فقرة جديدة؛ سطر جديد واحد لا يعني شيئًا. هذا مصدر الالتباس الأول. لفرض فاصل سطر دون فجوة فقرة، أنهِ السطر بمسافتين أو شرطة مائلة عكسية — عُرفان غير مرئيين سهلا التطبيق مستحيلا الرؤية، ولهذا يستخدم كثيرون الأسطر الفارغة فحسب.
- 2كتل الكود المُسيَّجة بوسم لغة تحصل على تلوين تركيب في كل مكان تقريبًا. ```python في بداية كتلة يخبر GitHub ومولّدات التوثيق ومعظم العارضات كيف تلوّن الكود. الكتل غير الموسومة تُعرض كخط أحادي عادي — الوسم لا يكلّف شيئًا ويستحق العادة.
- 3استخدم روابط النمط المرجعي للمستندات ذات الروابط المتكررة. كتابة [نص][1] في السياق و[1]: https://... في الأسفل تمنع الروابط الطويلة من تمزيق مقروئية مصدرك — وهو ما يهم، إذ نصف قيمة ماركداون أن المصدر ذاته مقروء.
- 4يعمل HTML الخام داخل ماركداون، لكنه باب باتجاه واحد. أي شيء لا يستطيع ماركداون التعبير عنه — القوائم المنسدلة، أصناف محددة، فيديو مضمَّن — يمكن كتابته كـHTML مباشرةً. لكن عارضات كثيرة تُعقّم أو تجرّد HTML للأمان، فيصير مستند يعتمد عليه رهين العارضة.
- 5أبقِ مستويات العناوين هرمية لا زخرفية. القفز من # لـ#### لأنه يبدو أجمل يكسر قارئات الشاشة ومولّدات جداول المحتويات وتحليل SEO معًا. إن كان الحجم البصري خاطئًا، فتلك مشكلة ورقة أنماط لا مشكلة بنية.
الأسئلة الشائعة
لماذا لا يظهر فاصل سطري؟
لأن ماركداون يعامل السطر الجديد الواحد كالتفاف ناعم لا فاصل — يضم الأسطر في فقرة واحدة. فاصل الفقرة الحقيقي يحتاج سطرًا فارغًا بين الكتل. إن أردت فاصل سطر دون بدء فقرة جديدة، أنهِ السطر بمسافتين لاحقتين أو شرطة عكسية. هذه أشيع مفاجآت ماركداون، وهي مقصودة، موروثة من أعراف بريد النص الصرف.
أي نكهة ماركداون تستخدم هذه الأداة؟
أعراف CommonMark مع الامتدادات التي روّجها GitHub — الجداول والشطب وكتل الكود المُسيَّجة. تغطي هذه التوليفة التركيب الذي يعمل على GitHub وGitLab ومعظم المنصات الحديثة. ماركداون الأصلي لعام 2004 كان فيه غموضات حلّتها الأدوات المختلفة بطرق مختلفة؛ وحّد CommonMark الإجابات، وصارت امتدادات GitHub الإضافات الفعلية التي يتوقعها الجميع.
كيف أصنع جدولًا؟
الأعمدة تفصلها خطوط عمودية، وصفّ شُرَط يفصل الترويسة: `| الاسم | العمر |` ثم `|------|-----|` ثم صفوف البيانات. تُضبط المحاذاة بنقطتين في صف الشُرَط — `:---` يسار، `:---:` وسط، `---:` يمين. لا تحتاج الخطوط العمودية للاصطفاف بصريًا، رغم أن المصدر المُحاذى أسهل تحريرًا. الجداول امتداد GitHub، فبعض المحلّلات الصارمة لن تعرضها.
هل أستطيع استخدام HTML داخل ماركداون؟
نعم — صُمّم ماركداون صراحةً للسماح بـHTML مباشر لأي شيء لا يستطيع التعبير عنه، وHTML على مستوى الكتل يمرّ دون مساس. التحفظات: تركيب ماركداون لا يعمل داخل كتل HTML، ومنصات كثيرة تُعقّم HTML للأمان، مجرّدةً السكربتات والأنماط وأحيانًا وسومًا كاملة. للمستندات التي تتحكم بها من طرف لطرف هو مخرج مفيد؛ وللمحتوى المنشور على منصات خارجية، ابقَ ضمن ماركداون.
هل يُرسَل نصي إلى خادم؟
لا. يعمل التحويل كليًا في متصفحك — يُحلَّل ماركداون ويُولَّد HTML محليًا، دون إرسال أو تخزين شيء. اقطع الإنترنت ويواصل المحوّل العمل. هذا يهم عند صياغة محتوى لم تنشره، إذ لا شيء تكتبه هنا يغادر جهازك.