معاينة Markdown
خاص — لا يُخزَّن ملفك أبدًا
383 حرفًا · 20 سطرًا
كيف تعمل الأداة
اكتب أو الصق
أو أفلِت ملف .md هنا. تتحدّث المعاينة أثناء الكتابة.
شاهده كما سيبدو
الجداول، وقوائم المهام، والنص المشطوب، والحواشي، والكود المسيّج بالألوان — نكهة GitHub، لا CommonMark العادي.
خذه معك
انسخ HTML، أو احفظ صفحة مستقلة تُفتح في أي مكان وتُطبع بشكل سليم.
أي Markdown، ولماذا يُنقّى HTML
Markdown عائلة لا مواصفة واحدة، واللهجة المعتمدة هنا هي مجموعة GitHub المتفق عليها على نطاق واسع: العناوين، والتأكيد، والقوائم، والروابط، والصور، والاقتباسات الكتلية، والجداول، وكتل الكود المسيّجة مع تلوين الصياغة، وقوائم المهام، والنص المشطوب، والحواشي، والروابط التلقائية. هذا ما يكتبه الجميع تقريبًا وما سيحتويه ملف README. أما اللهجات الأكثر غرابة والإضافات المخصصة التي يضيفها موقع بعينه — كتل التنبيهات، والرموز المختصرة (shortcodes)، والقوالب — فليست مدعومة، لذا قد يظهر جزء من صياغة مستند كُتب لمولّد معيّن كما هو حرفيًا.
يُعرض HTML الخام لكن بعد تنقيته أولًا، وهذا هو الجزء الذي يستحق الفهم. يسمح Markdown عمدًا بـ HTML داخله، ما يعني أن ملف Markdown من أي مصدر قد يحتوي على وسم script أو معالج أحداث مضمّن أو iframe أو رابط javascript:. عرض ذلك كما هو سيشغّل كود شخص غريب في جلستك لمجرد أنك لصقت ملف README الخاص به لتلقي نظرة. يُحذف كل ما هو قابل للتنفيذ قبل عرض أي شيء، فيبقى التنسيق ولا يبقى الكود.
وهذا درس عام لا تفصيل خاص بهذه الصفحة. أي نظام يعرض Markdown يقدّمه المستخدمون — مربع تعليقات، أو ويكي، أو تذكرة دعم — يعرض HTML يقدّمه المستخدمون ما لم يُنقّه، وعبارة «إنه مجرد Markdown» هي الطريقة التي يُغفل بها ذلك. تحويل Markdown ليس حاجزًا أمنيًا؛ خطوة التنقية هي الحاجز.
ما تحصل عليه هو معاينة للمحتوى، لا لموقع بعينه. GitHub وGitLab ومولّدات التوثيق يطبّق كل منها ملف أنماطه ومراسي عناوينه وامتداداته الخاصة، لذا يبدو الملف نفسه مختلفًا في كل منها — والبنية المعروضة هنا هي ما تتفق عليه جميعها. لا يُجلب أي شيء، لذا فالصور المشار إليها بعنوان ويب لا تُحمَّل إلا إذا سمح الخادم بذلك، أما المسارات النسبية إلى ملفات في مستودع فلا يمكن حلّها إطلاقًا.
عندما تحتاج إلى شيء آخر
لملف README تكتبه فعلًا، عاينه حيث سيعيش. محرر GitHub نفسه يعرض المعاينة بالعرض والامتدادات والمراسي نفسها تمامًا، وGitHub CLI — gh markdown-preview — يفعل ذلك محليًا بالمحرّك نفسه. وللتوثيق، يوفّر المولّد نفسه (MkDocs أو Docusaurus أو Hugo) معاينة تُعاد تحميلها تلقائيًا وتعرض التنسيق والتنقل الحقيقيين، وهو ما سيراه القارئ.
للتحرير لا للفحص، يتفوق محرر Markdown بلوحة معاينة حية — Obsidian أو Typora أو VS Code بمعاينته المدمجة — على اللصق في صفحة في كل مرة، لأن المعاينة تتحدّث أثناء الكتابة ويبقى الملف في مكانه. هذه الصفحة لقراءة Markdown كتبه شخص آخر، أو لإلقاء نظرة سريعة على شيء أُرسل إليك.
الأسئلة الشائعة
هل يُخزَّن مستندي في أي مكان؟
لا. لا يُخزَّن أي شيء ولا يُحتفظ بأي شيء، وتعمل الأداة حتى مع إيقاف Wi-Fi بعد تحميل الصفحة. الملاحظات والمسودات والتوثيق الداخلي هي بالضبط نوع الأشياء التي يلصقها الناس في أداة معاينة دون تفكير.
ما نكهة Markdown المستخدمة هنا؟
نكهة GitHub، لأن هذا ما تعنيه كلمة «Markdown» عمليًا اليوم. الجداول وقوائم المهام والنص المشطوب والروابط التلقائية والحواشي وكتل الكود المسيّجة بألوان الصياغة كلها تعمل. أدوات معاينة CommonMark العادية لا تدعم أيًّا منها، ولهذا يبدو ملف README السليم على GitHub معطوبًا فيها.
هل يمكنني استخدام HTML الخام فيه؟
نعم، ويُنقّى قبل عرضه. يسمح Markdown بـ HTML الخام، وهذه المعاينة تعرضه — لكن كل ما يمكن أن يشغّل سكربتًا يُحذف أولًا، لأن لصق ملف README لشخص آخر لا ينبغي أبدًا أن يشغّل كوده. يبقى التنسيق والروابط والصور كلها.
هل يلوّن كتل الكود؟
نعم، مع اكتشاف اللغة، للغات التي تتوقعها في ملف README — بأداة التلوين نفسها التي تستخدمها أدوات العرض على طريقة GitHub. اكتب اسم اللغة بعد السياج الافتتاحي وستُلوَّن وفقًا لها.
هل يمكنني تحويله إلى PDF؟
أداة [تحويل Markdown إلى PDF](markdown-to-pdf) لدينا تفعل ذلك بالضبط، مع فواصل صفحات سليمة وتنسيق طباعي متقن. هذه الصفحة للقراءة والفحص؛ وتلك لإنتاج مستند.
ماذا عن الصور في ملف Markdown؟
الصور المشار إليها بعنوان ويب تُحمَّل بشكل عادي. أما الصور المشار إليها بمسار نسبي — «» — فلا يمكن قراءتها، لأن صفحة الويب لا تملك وصولًا إلى المجلد الذي يوجد فيه ملفك. تظهر هذه الصور كعنصر نائب يذكر اسم الملف المفقود، بدلًا من أيقونة معطوبة.
معلومة مفيدة: يُعرض HTML الخام داخل Markdown، لكن بعد تنقيته أولًا — تُحذف السكربتات ومعالجات الأحداث وكل ما يمكن تشغيله، فلا يمكن للصق ملف README لشخص آخر أن يشغّل كوده. نكهة Markdown الخاصة بـ GitHub مدعومة؛ أما اللهجات الأكثر غرابة والإضافات المخصصة فلا.
أضِف هذه الأداة إلى موقعك
مجانية لأي مدونة أو صفحة فصل دراسي أو مقالة مساعدة. الصق مقتطفًا واحدًا وسيتمكن زوارك من استخدامها مباشرةً على صفحتك.