Markdown إلى HTML

لهجات Markdown ليست متبادلة

يغطي Markdown الأساسي العناوين والتشديد والقوائم والروابط والشيفرة، ويثبّت CommonMark الزوايا الغامضة كي تتفق البرامج المختلفة. ويضيف GitHub Flavored Markdown (GFM) الجداول وقوائم المهام والشطب والروابط التلقائية، وهي الميزات التي يفترض معظم الناس أنها قياسية. وتضيف لهجات أخرى الحواشي وقوائم التعريف والرياضيات والبيانات الأولية، والمحوّل الذي لا يعرفها إما يُسقط المحتوى وإما يطبع الصيغة الخام في المخرجات. وقبل التحويل تحقق من اللهجة التي يستخدمها مصدرك ومن اللهجة التي يقبلها هدفك؛ وإن لم تكن متأكداً فالتزم بـ CommonMark مع الجداول، فهي مدعومة في كل شيء تقريباً.

استخدام النتيجة في الواقع العملي

الوجهة التي سيذهب إليها الملف المحوّل هي التي تحدد الصيغة التي ينبغي أن تنتجها. فاللصق في نظام إدارة محتوى أو في مركز مساعدة يعني HTML عادةً، لأن تلك الأنظمة تخزّن الترميز وتعرضه من جديد. وإرسال عقد أو فاتورة أو أي شيء سيوقّعه أحدهم يعني PDF، لأن التخطيط ثابت ولا يمكن تعديل الملف عن طريق الخطأ. والتحرير لاحقاً يعني Word، لأن الناس سيفتحونه به فعلاً. أما تغذية سكربت أو مولّد موقع ثابت فتعني إبقاءه Markdown. والتحويل إلى هدف خاطئ هو السبب الأكثر شيوعاً لأن يبدو المستند «خطأً» بعد ذلك: فالمحتوى سليم، لكن الوجهة لم تكن لتحفظ ذلك التنسيق بعينه أبداً.