تحويل Markdown إلى HTML
يحوّل Markdown إلى HTML باستخدام مكتبة markdown-js التي تتبع الصياغة الأصلية لجون غروبر. يُهرَّب HTML الخام في المصدر كنص، ولا تُتعرَّف امتدادات GitHub مثل الجداول وكتل الشيفرة المسوّرة.
لصق قسم من README أو ملاحظات إصدار في حقل CMS لا يقبل إلا HTML.
متى تستخدمها
- لصق قسم من README أو ملاحظات إصدار في حقل CMS لا يقبل إلا HTML.
- التحقق من وسوم HTML التي ينتجها مقطع من Markdown الأساسي.
طريقة الاستخدام
- الصق Markdown في المحرر الأيسر أو حمّل ملف .md.
- اقرأ HTML المُنشأ على اليمين وتحقق في المعاينة أسفله من كل عنوان وقائمة ورابط.
- انسخ HTML؛ فهو يحتوي على ترميز body فقط، لذا أضف CSS الخاص بك حيث تلصقه.
Markdown
## Install
Run the **CLI** once:
npm install -g douni
1. Open the [docs](https://douni.one)
2. Paste your file
| a | b |HTML
<h2>Install</h2> <p>Run the <strong>CLI</strong> once:</p> <pre><code>npm install -g douni</code></pre> <ol> <li>Open the <a href="https://douni.one">docs</a></li> <li>Paste your file</li> </ol> <p>| a | b |</p>
التفاصيل والقيود
يجري التحويل في المتصفح. المخرجات جزء HTML بلا <html> أو <head> أو ورقة أنماط؛ وتعرضه المعاينة في إطار معزول مع تعطيل السكربتات.
لا يُدعم إلا Markdown الأصلي. تبقى جداول الخطوط العمودية وقوائم المهام و~~الشطب~~ وكتل ``` المسوّرة نصًا؛ استخدم مسافة بادئة من 4 مسافات لكتل الشيفرة.
يُهرَّب HTML المضمّن مثل <div> إلى <div> ولا يُمرَّر كما هو.
تصبح الصور وسوم <img> تشير إلى عنوان URL الأصلي؛ لا تُضمَّن الملفات.
FAQ
لماذا لا تتحول أسوار ``` إلى كتل <pre>؟
المكتبة أقدم من الشيفرة المسوّرة. يُعامل السور كشيفرة مضمّنة داخل فقرة. أضف أربع مسافات بادئة للشيفرة للحصول على <pre><code>.
هل يدعم جداول GitHub Flavored Markdown؟
لا. يُخرَج سطر مثل | a | b | كفقرة عادية.
هل يمكنني الإبقاء على HTML الخام في Markdown؟
لا. تُهرَّب وسوم HTML وتظهر كنص في النتيجة، لذا لن يُعرض <div> المضمّن كعنصر.