تحويل Markdown إلى HTML
في Markdown يصبح "# Hello" <h1>Hello</h1>، ويصبح "**bold**" <strong>bold</strong>، ويصبح "[text](https://example.com)" <a href="https://example.com">text</a>.
طريقة الاستخدام
- اكتب Markdown أو الصقه في مربع الإدخال. هناك مثال محمَّل لترى النتيجة فورًا.
- بدّل بين المعاينة التي تعرض الصفحة المعروضة، وHTML الذي يعرض الكود المصدري.
- اضغط نسخ HTML لنسخ المصدر. تتحدث النتيجة أثناء الكتابة.
- أبقِ خيار السماح بـ HTML الخام معطلًا للنصوص غير الموثوقة. فعّله فقط إذا كان Markdown لديك يحتوي وسوم HTML تريد إبقاءها في الناتج. وتبقى المعاينة منقّاة في الحالتين.
طريقة الحساب
يقرأ المحول Markdown على مرحلتين، متبعًا قواعد CommonMark في الأجزاء التي يدعمها. أولًا يقسم النص إلى كتل: عناوين وفقرات وقوائم واقتباسات وكتل كود وخطوط أفقية. ثم يقرأ النص داخل كل كتلة بحثًا عن التأكيد والكود والروابط والصور.
المدعوم: عناوين # والعناوين المسطَّرة، والفقرات وفواصل الأسطر، و*المائل* و**العريض**، و`الكود المضمَّن`، وكتل الكود المسوّرة والمزاحة، واقتباسات >، والقوائم النقطية والمرقمة المتداخلة، و[الروابط](url "title")، و، والروابط التلقائية <https://links>، والروابط المرجعية، والخطوط ---. غير المدعوم: الجداول والحواشي وقوائم المهام والشطب، فهي من إضافات نمط GitHub لا من CommonMark.
الأمان على طبقتين. افتراضيًا يُهرَّب أي HTML مكتوب في Markdown، فيظهر <script> نصًا. وتُفحص عناوين الروابط والصور، فلا يُسمح إلا بروابط http وhttps وmailto وtel (وhttp وhttps للصور)، فتُحذف عناوين javascript: وdata:. وقبل رسم المعاينة يمر HTML عبر مرشح ثانٍ بقائمة سماح يُبقي الوسوم والسمات المعروفة ويحذف كل ما عداها، بما في ذلك كل معالجات الأحداث on* وسمات style.
تُفتح الروابط في المعاينة في تبويب جديد مع rel="noopener noreferrer nofollow". أما HTML الذي تنسخه فهو ناتج المحول دون هذه الإضافات.
مرجع سريع لصياغة Markdown
| ما تكتبه | ما تحصل عليه | HTML |
|---|---|---|
| # Heading | عنوان من المستوى 1 | <h1> |
| **bold** | خط عريض | <strong> |
| *italic* | خط مائل | <em> |
| `code` | كود | <code> |
| - item | قائمة نقطية | <ul><li> |
| 1. item | قائمة مرقمة | <ol><li> |
| > quote | اقتباس | <blockquote> |
| [text](url) | رابط | <a href> |
|  | صورة | <img> |
| --- | خط أفقي | <hr /> |
أسئلة شائعة
هل معاينة Markdown غير موثوق آمنة؟
نعم. يُهرَّب HTML في النص افتراضيًا، وتُحذف مخططات الروابط الخطرة، وتُرشَّح المعاينة مرة أخرى قبل عرضها. لا يمكن تشغيل النصوص البرمجية ولا معالجات الأحداث. لكن الصور التي تربط إليها تُحمَّل من خوادمها.
لماذا يظهر وسم HTML عندي نصًا؟
خيار السماح بـ HTML الخام معطل، فتُهرَّب الوسوم عمدًا. فعّله لتمرير الوسوم إلى ناتج HTML. وتظل المعاينة تحذف كل ما هو غير آمن كوسوم script.
هل يدعم الجداول وقوائم المهام؟
لا. الجداول وقوائم المهام والحواشي والشطب إضافات GitHub Flavored Markdown. هذه الأداة تغطي ميزات CommonMark الأساسية.
كيف أضيف فاصل سطر داخل فقرة؟
أنهِ السطر بمسافتين أو بشرطة مائلة عكسية. أما فاصل السطر الواحد فيُعامل مسافة، كما في CommonMark.
كيف أعرض نجمة أو شرطة سفلية حرفيًا؟
ضع قبلها شرطة مائلة عكسية، مثل \* أو \_. ولا حاجة للتهريب داخل الكود المضمَّن أو كتلة الكود.
هل يُرفع نصي؟
لا. التحويل والمعاينة يجريان في متصفحك.