من Markdown إلى HTML

تحوِّل الأداة Markdown إلى HTML باستخدام CommonMark وGitHub Flavored Markdown (GFM)، مع تصيير كسور السطر داخل الفقرة بوصفها <br>. يمكنك مشاهدة المعاينة المُصيَّرة أو التبديل إلى عرض مصدر HTML لفحص الوسوم المولَّدة. الناتج جاهز للصقه في منصات التدوين وبرامج البريد وأي مكان يقبل HTML.

مثال

إدخال Markdown:

# Release notes

We shipped **three** things this week:

- [x] Faster cold start
- [ ] Dark mode (next week)

See the [docs](https://example.com/docs) for details.

```js
console.log("hello");
```

مصدر HTML المُصيَّر:

<h1>Release notes</h1>
<p>We shipped <strong>three</strong> things this week:</p>
<ul>
<li><input type="checkbox" checked disabled> Faster cold start</li>
<li><input type="checkbox" disabled> Dark mode (next week)</li>
</ul>
<p>See the <a href="https://example.com/docs">docs</a> for details.</p>
<pre><code class="language-js">console.log("hello");
</code></pre>

الأخطاء الشائعة والملاحظات

معظم مفاجآت التصيير في Markdown تنبع من مجموعة محدودة من فِخاخ الصيغة. إذا بدت المعاينة غير صحيحة فالسبب غالبًا أحد الآتي.

• سطر فارغ مفقود قبل القائمة. كتابة "نص تمهيدي\n- عنصر" تُصيَّر كفقرة واحدة. اترك سطرًا فارغًا بين التمهيد وأول عنصر في القائمة.
• كتلة كود بمسافة بادئة بدل الفقرة. أربع مسافات في بداية السطر تحوِّله إلى كتلة كود. أزِل الإزاحة أو استخدم كتلة ``` صريحة.
• جدول معطوب. يحتاج كل جدول GFM إلى صف فاصل (| --- | --- |) بثلاث شرطات على الأقل لكل عمود، وعدد العارضات (|) نفسه في كل صف.
• رابط يحتوي مسافات في عنوان URL. [اضغط](my page.html) يعطّل المحلِّل. شفِّر المسافة بـ %20 أو استخدم قوسي زاوية: <my page.html>.
• نجوم داخل الكلمات. قد تُصيَّر wild*card كـ emphasis أو لا، وفق المحيط. اِستَخدم الشرطة المائلة العكسية للهروب: wild\*card.
• هروب HTML داخل كُتل الكود. المقاطع التي تحتوي &lt; تظهر كما هي لأنها مَهروبة مسبقًا. ألصق المصدر الخام قبل الهروب.

ما نكهة Markdown المدعومة هنا؟

CommonMark مع GitHub Flavored Markdown (GFM). يشمل ذلك الجداول وكتل الكود المسيَّجة وقوائم المهام والشطب وروابط URL التلقائية. تتحوَّل كسور السطر داخل الفقرة إلى وسوم <br> لأن خيار breaks مفعَّل — وهذا يطابق تصيير تعليقات GitHub ومعظم تطبيقات المحادثة.

هل يُعقَّم HTML الموجود داخل Markdown الخاص بي؟

لا. تسمح المعاينة بمرور HTML الخام افتراضيًا. هذا يبقي أشياء مثل <details> أو <kbd> تعمل. لا تلصق Markdown غير موثوق وتنسخ الناتج إلى موقع عام دون تمريره أولًا عبر مُعقِّم مثل DOMPurify.

هل تُدعم الحواشي أو الرياضيات أو المخططات؟

لا. هذه GFM صِرف. الحواشي والرياضيات (KaTeX/MathJax) ومخططات Mermaid هي امتدادات GitHub أو منصَّات، ولا تُصيَّر هنا. إن احتجتها فاستخدم مُصيِّر Markdown مهيَّأً بالإضافات المناسبة، أو ألصق الناتج في منصَّة تدعمها.

ماذا يحدث عند الضغط على "نسخ HTML"؟

يُكتب مصدر HTML المُصيَّر إلى الحافظة عبر Clipboard API. تحصل على HTML بلا غلاف الصفحة — فقط الوسوم المقابلة لِـ Markdown. ألصقه في CMS أو محرر بريد أو مباشرة في ملف. لا تُنشأ ملفات على القرص.

لماذا تبدو جداولي غير محاذاة؟

تحتاج جداول GFM إلى صف رأس، وصف فاصل بثلاث شرطات على الأقل لكل عمود، وعارضات بين الخلايا. إن غابت عارضة أو كان الصف الفاصل بشرطتين فقط فإنه يفشل بصمت. بدِّل إلى عرض مصدر HTML لترى ما إذا كان <table> قد أُنتج فعلًا.

هل تحفظون Markdown الذي ألصقه هنا؟

لا. لا نحفظ ما تكتبه أو تلصقه من Markdown، ولا نحتفظ بـ HTML الذي تنزله. يُحذف كل شيء عند إغلاق علامة التبويب أو تحديثها — بلا سجلات، ولا أي أثر عندنا لما كتبت. يمكنك التحقق في أدوات مطوري المتصفح.