محوّل Markdown إلى HTML
حوّل Markdown إلى HTML مع معاينة مباشرة، أو حوّل HTML إلى Markdown نظيف، بما في ذلك الجداول وكتل الشيفرة.
محوّل Markdown إلى HTML - ومن HTML إلى Markdown
اكتب Markdown أو الصقه وشاهده معروضًا أثناء الكتابة، مع شيفرة HTML التي تقف خلفه على بُعد نقرة واحدة. أو اسلك الاتجاه المعاكس: الصق HTML من صفحة ويب أو نظام إدارة محتوى أو رسالة بريد إلكتروني، واحصل على Markdown نظيف لملف README أو ويكي أو موقع ثابت. الجداول وقوائم المهام والنص المشطوب وكتل الشيفرة المسوّرة من GitHub Flavored Markdown تعمل في الاتجاهين، وكل شيء يجري داخل متصفحك.
Markdown هو ما يكتب به المطورون التوثيق، وما تخزّن به تطبيقات ملاحظات كثيرة نصوصها، وما تنسّق به GitHub وGitLab وStack Overflow المنشورات. أما HTML فهو ما يحتاجه المتصفح. والتحويل بينهما يدويًا عمل مملّ وسهل الخطأ.
طريقة الاستخدام
- اختر Markdown → HTML أو HTML → Markdown.
- اكتب النص أو الصقه؛ فتتحدّث النتيجة أثناء الكتابة.
- في وضع Markdown، بدّل بين معاينة وHTML، وفعّل صفحة HTML كاملة للحصول على مستند كامل.
- اضغط نسخ أو تنزيل. وعند تبديل الاتجاه تنتقل النتيجة معك، فتستطيع التحويل ذهابًا وإيابًا.
صياغة Markdown في لمحة
| Markdown | النتيجة |
|---|---|
# Title, ## Section | عناوين من المستوى 1 و2 |
**bold**, *italic*, ~~struck~~ | نص عريض، ومائل، ومشطوب |
[text](https://example.com) | رابط |
 | صورة |
- item أو 1. item | قائمة نقطية أو مرقّمة |
- [x] done | عنصر في قائمة مهام |
`code` وكتل مسوّرة بـ ``` | شيفرة ضمن السطر وكتل شيفرة |
| a | b | صفوف مع سطر |---| | جدول |
> quote | اقتباس |
فواصل الأسطر
في Markdown القياسي يُتجاهل فاصل السطر المفرد داخل الفقرة؛ فأنت تحتاج إلى سطر فارغ لبدء فقرة جديدة، أو إلى مسافتين في نهاية السطر لكسره. ويتوقع كثيرون أن يظهر كل فاصل سطر، لأن هذا ما تفعله تعليقات GitHub. فعّل الإبقاء على فواصل الأسطر المفردة للحصول على هذا السلوك.
من HTML إلى Markdown
عند لصق HTML تتحول العناوين والفقرات والروابط والصور والقوائم والجداول والاقتباسات وكتل الشيفرة إلى ما يقابلها في Markdown. أما السكربتات والأنماط وكل ما لا يستطيع Markdown التعبير عنه، كالألوان والتخطيط، فتُحذف، وهذا عادةً ما تريده عند نقل محتوى إلى README أو موقع توثيق. ويمكنك الاختيار بين عناوين بـ علامات # وعناوين بخط تحتي، وتحديد علامة القائمة.
الأمان
قد يحتوي Markdown على HTML خام، بما في ذلك السكربتات. تُعرض المعاينة داخل إطار معزول (sandbox) لا تعمل فيه السكربتات ولا يستطيع الوصول إلى هذه الصفحة، فلا يستطيع مستند ملصوق أن يُحدث أي ضرر هنا. لكن مخرجات HTML لا تُنقّى: فإذا جاء Markdown من شخص لا تثق به، فنظّف HTML قبل نشره على موقع ويب.
أدوات ذات صلة
لإزاحة HTML الناتج أو ضغطه، استخدم منسّق الأكواد. ولعدّ كلمات مستندك، استخدم عدّاد الكلمات. وتفتح صفحات المهام هذه الأداة على مهمة واحدة: تحويل HTML إلى Markdown ومعاينة Markdown.