معاينة Markdown
إعداد مسبق لأداة Markdown إلى HTML
اكتب Markdown وشاهده مُعرَضًا فورًا. مفيد لصياغة ملف README، وصف طلب سحب، أو توثيق قبل الالتزام (commit) به — مع المعاينة المعزولة في إطار حتى لا يستطيع المحتوى المُلصَق تنفيذ أي شيء.
- الملفات لا تغادر جهازك أبدًا
- مجاني، بدون تسجيل
- بدون علامات مائية
- يعمل دون اتصال بعد التحميل
كيفية استخدام Markdown إلى HTML
- 1
اكتب أو الصق Markdown
يتحدَّث HTML والمعاينة أثناء الكتابة.
- 2
تحقق من المعاينة
مُعرَضة في إطار معزول، حتى لا يستطيع المحتوى المُلصَق تنفيذ نصوص برمجية.
- 3
انسخ HTML
انسخ الترميز أو نزّله كملف .html.
لماذا تتفوق الصياغة مع المعاينة على تخمين الصياغة الخام
كل جاذبية Markdown أنه يمكن كتابته وقراءته كنص عادي، لكن تلك البساطة نفسها بالضبط ما يجعل أخطاءً معينة غير مرئية حتى تُعرَض — جدول يفتقد حرف عمودي في صف فاصله يعود بصمت للعرض كفقرة عادية بدلًا من جدول، قائمة متداخلة بمسافة بادئة بعدد خاطئ من المسافات تُلحَق بالعنصر الأب الخاطئ، ولا توجد رسالة خطأ لأي من المشكلتين، فقط إخراج لا يبدو بصمت كما كان مقصودًا. رؤية النتيجة المُعرَضة الفعلية تتحدَّث باستمرار أثناء الكتابة يكتشف بالضبط هذا النوع من خطأ التنسيق في اللحظة التي يُدخَل فيها، وهذا أسرع بكثير من كتابة ملف README كامل أو وصف طلب سحب بشكل أعمى واكتشاف أن التنسيق انكسر فقط بعد نشره في مكان ما بالفعل.
الصياغة لوجهة معينة
يمكن لـGitHub، وموقع توثيق، ومنشور منتدى عرض نفس مصدر Markdown مختلفًا قليلًا في الحالات الحدّية حتى مع دعم الجميع لـGFM على نطاق واسع، لذا المعاينة قبل النشر تستحق العناء خاصة عندما تكون الوجهة مكانًا سيكون فيه خطأ عرض مرئيًا لجمهور واسع — ملف README عام، إعلان إطلاق، أو وصف طلب سحب سيقرأه المراجعون فعليًا بانتباه.
الأسئلة الشائعة
أي نسخة من Markdown مدعومة؟
GitHub Flavored Markdown: جداول، كتل كود مُسيَّجة، قوائم مهام، نص مشطوب وروابط تلقائية، فوق نواة CommonMark. هذه اللهجة التي يستخدمها GitHub وReddit ومعظم مولّدات المواقع الثابتة.
هل من الآمن لصق Markdown من مصدر غير موثوق؟
تُعرَض المعاينة داخل iframe معزول بنصوص برمجية معطَّلة، لذا لا يمكن لوسوم `<script>` المُضمَّنة ومعالِجات الأحداث التنفيذ. لاحظ أن *HTML المُولَّد* لا يزال يحتوي أي HTML خام كان في Markdown الخاص بك — طهِّره في الخادم قبل نشر محتوى لم تكتبه أنت.
هل يدعم HTML خامًا داخل Markdown؟
نعم — يسمح Markdown بـHTML مضمَّن ويُنقَل كما هو. هذا ما يجعل ملاحظة التطهير أعلاه مهمة إذا لم يكن المصدر موثوقًا.
لماذا لا يُعرَض جدولي؟
تحتاج جداول GFM صف فاصل من الشرطات تحت الترويسة، وسطرًا فارغًا في البداية إذا تبع الجدول فقرة. علامة عمودية واحدة مفقودة في صف الفاصل تُحوِّل كل شيء بصمت مرة أخرى إلى نص عادي.