یہ ٹول کیسے کام کرتا ہے
Markdown کو HTML میں بدلتا ہے اور مارک اپ کے ساتھ ہی تیار شدہ نتیجے کا لائیو پیش منظر دکھاتا ہے۔
Markdown کو پارس کر کے HTML کے طور پر پیش کیا جاتا ہے، پھر پیش منظر دکھانے سے پہلے اسے صاف کیا جاتا ہے: script ٹیگ، ایونٹ ہینڈلر کی خصوصیات اور javascript: والے پتے نکال دیے جاتے ہیں، کیونکہ پیش منظر وہی دکھاتا ہے جو اِن پُٹ اسے کہے، اور Markdown خام HTML کی اجازت بطورِ ڈیزائن دیتا ہے۔ تبدیلی عام CommonMark سے ماخوذ رویّے کی پیروی کرتی ہے، اور یہ جاننا اہم ہے کیونکہ Markdown کوئی ایک تصریح نہیں ہے — جدول، ٹاسک لسٹ، خط زدہ متن اور فٹ نوٹ توسیعات ہیں، جو کچھ پروسیسرز میں موجود ہیں اور کچھ میں نہیں، اس لیے یہاں کام کرنے والا آؤٹ پُٹ کہیں اور جوں کا توں نہ چل سکے۔
وہ Markdown جو ساتھ نہیں چلتا
- Markdown ایک خاندان ہے، معیار نہیں: جدول اور ٹاسک لسٹ توسیعات ہیں۔ ان پر انحصار کرنے والی دستاویز ایسے پروسیسر میں مختلف نظر آئے گی جو وہی مجموعہ نافذ نہیں کرتا۔
- پیش منظر صاف کیا جاتا ہے، آؤٹ پُٹ نہیں: دکھانے سے پہلے ہر قابلِ عمل چیز نکال دی جاتی ہے۔ اگر آپ تیار شدہ HTML کسی صفحے میں چسپاں کرتے ہیں تو اس کے مواد کی ذمہ داری آپ کی ہے۔
- خام HTML بغیر تبدیلی گزر جاتا ہے: Markdown اس کی اجازت جان بوجھ کر دیتا ہے۔ یہ کارآمد ہے اور یہی وجہ ہے کہ غیر بھروسہ مند Markdown کو کبھی بغیر صفائی کے پیش نہیں کرنا چاہیے۔
- لائن بریک عام طور پر حیران کرتے ہیں: زیادہ تر پروسیسرز میں ایک نئی سطر بریک نہیں بناتی۔ سطر کے آخر میں دو خالی جگہیں، یا نئے پیراگراف کے لیے ایک خالی سطر، وہی کام کرتی ہیں۔