كيف تعمل
- اكتب أو ألصق Markdown.
- راقب تحديث المعاينة.
- انسخ HTML أو احفظ المستند.
لماذا تستخدمها
- صيغة Markdown بطراز GitHub.
- كتل كود ملوّنة نحويًا.
- خرج HTML مُنقّى.
- انسخ HTML أو اطبع إلى PDF.
الكتابة بـMarkdown وتحويلها إلى HTML
Markdown في دقيقتين
Markdown نص عادي ببضع علامات تتحول إلى تنسيق. هكذا تُكتب ملفات README والتوثيق ومشاركات المنتديات وتطبيقات الملاحظات، لأنه يبقى مقروءًا كنص عادي ويتحول بنظافة إلى HTML.
| تكتب | تحصل على |
|---|---|
# عنوان و## قسم | عناوين من المستوى 1 و2 |
**عريض** و*مائل* | نص عريض ومائل |
[نص](https://example.com) | رابط |
- بند أو 1. بند | قائمة نقطية أو مرقمة |
- [ ] مهمة و- [x] منجزة | قائمة مهام بخانات اختيار |
> اقتباس | كتلة اقتباس |
| ثلاث علامات backtick، واسم لغة، وشيفرة، وثلاث علامات backtick | كتلة شيفرة بألوان الصياغة |
أسطر | a | b | مع سطر |---|---| | جدول |
في الجداول تحدد النقطتان في سطر الفصل محاذاة العمود: |:---| يحاذي يسارًا، و|:---:| يوسّط، و|---:| يحاذي يمينًا، كما تُصف أعمدة الأرقام عادةً.
شريط الأدوات يُدرج العلامات نفسها لك: عريض ومائل وعنوان ورابط وقوائم وقائمة مهام واقتباس وشيفرة. الصق ملف .md أو افتحه لتعمل على مستند موجود.
الحصول على HTML
- نسخ HTML ينسخ المحتوى فقط، جاهزًا للصق في منشئ مواقع أو نظام إدارة محتوى أو قالب بريد إلكتروني.
- تنزيل HTML يحفظ صفحة ويب كاملة بأنماط أساسية، تُفتح في أي متصفح ويمكن إرسالها كملف.
- طباعة يفتح نافذة الطباعة مع المعاينة، حيث يعطي اختيار الحفظ بتنسيق PDF ملف PDF مرتبًا للمستند.
تحصل كتل الشيفرة على ألوان الصياغة لـJavaScript وTypeScript وJSON وCSS وHTML وسكربتات shell وغيرها حين تسمي اللغة بعد علامات backtick الافتتاحية.
HTML آمن
Markdown يقبل HTML خامًا بداخله، فقد يحمل مستند ملصوق من مكان آخر سكربتًا. المعاينة وHTML المصدّر يمران عبر DOMPurify، منقٍّ واسع الاستخدام، يزيل السكربتات ومعالجات الأحداث وغيرها من المحتوى النشط مع إبقاء التنسيق العادي. وهذا يُبقي الصفحة آمنة للمعاينة وHTML آمنًا للنشر.
الكتابة براحة
بدّل بين تخطيطات كتابة وتقسيم ومعاينة؛ والعرض المقسم يُبقي المعاينة عند الجزء الذي تكتبه حين يكون مزامنة التمرير مفعّلًا. تُحفظ المسودة في هذا المتصفح أثناء الكتابة، فلا يُفقدها إغلاق التبويب؛ وتبقى على هذا الجهاز فقط. لإحصاءات مثل عدد الكلمات ووقت القراءة الصق النص في عدّاد الكلمات.
إذا حدث خطأ
- قائمة أو جدول لا يظهر. يحتاج Markdown سطرًا فارغًا قبل القائمة أو الجدول الذي يلي فقرة.
- فواصل الأسطر تختفي. في Markdown يضم فاصل السطر الواحد الأسطر في فقرة واحدة. اترك سطرًا فارغًا بين الفقرات.
- أُزيل جزء من HTML. كان محتوى نشطًا، كسكربت أو معالج أحداث مضمّن، أُزيل لأسباب أمنية.
أسئلة وأجوبة
كيف أحوّل Markdown إلى HTML؟
ألصق Markdown في المحرر وانسخ خرج HTML.
هل HTML آمن للنشر؟
نُقّي بـDOMPurify، الذي يزيل السكربتات والسمات غير الآمنة.
هل يُحفظ ما أكتبه؟
لا، يبقى داخل متصفحك.