Markdown کو PDF میں تبدیل کریں

کون سا Markdown، اور یہ کیا بنتا ہے

Markdown کوئی ایک اسپیسیفکیشن نہیں بلکہ ایک خاندان ہے۔ بنیادی حصہ — ہیڈنگز، ایمفیسس، فہرستیں، لنکس، تصاویر، بلاک کوٹس، کوڈ بلاکس — ہر جگہ ایک جیسا ہے، اور اس سے آگے ہر امپلیمنٹیشن الگ ہے۔ یہاں وہ وسیع پیمانے پر مانا گیا توسیعی سیٹ سپورٹ ہے: ٹیبلز، سنٹیکس ہائی لائٹنگ والے فینسڈ کوڈ بلاکس، ٹاسک لسٹس، اسٹرائیک تھرو، فٹ نوٹس اور فرنٹ میٹر۔ تقریباً ہر کوئی جو لکھتا ہے وہ اس میں آ جاتا ہے، اور حد کو پہلے سے جان لینا بعد میں دریافت کرنے سے بہتر ہے۔

ہیڈنگز صرف بڑا ٹیکسٹ نہیں بلکہ PDF کا اصل ڈھانچہ بنتی ہیں: ان کے آؤٹ لائن لیولز ہوتے ہیں، اس لیے PDF میں ایسا بک مارک سائیڈبار بنتا ہے جس سے آپ گھوم سکیں۔ لنکس کام کرنے والی لنک اینوٹیشنز بنتے ہیں۔ کوڈ بلاکس ہائی لائٹنگ کے ساتھ مونو اسپیسڈ فونٹ میں لکھے جاتے ہیں، اور یہی پڑھنے میں خوشگوار دستاویز اور سرمئی دیوار کا فرق ہے۔ صفحے کا سائز اور مارجنز کہیں سے لیے نہیں جاتے بلکہ پڑھنے کے لیے چنے جاتے ہیں، کیونکہ Markdown فائل کی کاغذ کے بارے میں کوئی رائے نہیں ہوتی۔

تصاویر تک رسائی ہونی چاہیے، اور سب سے عام مایوسی یہی ہے۔ Markdown فائل تصاویر اپنے اندر نہیں رکھتی بلکہ ان کا حوالہ دیتی ہے، اس لیے ریلیٹو پاتھ تب ہی ملتا ہے جب تصویر فائل کے ساتھ ڈراپ کی گئی ہو، اور ویب ایڈریس تب ہی جب وہ سرور دوسری سائٹس کو اسے لانے دے۔ جو تصویر نہ ملے اس کی جگہ خاموش خلا چھوڑنے کے بجائے PDF میں اس پر لیبل لگایا جاتا ہے، اس لیے غائب خاکہ نظر آتا ہے، دستاویز بھیجنے کے بعد پتا نہیں چلتا۔

دو چیزیں جان بوجھ کر رینڈر کرنے کے بجائے کوڈ کے طور پر دکھائی جاتی ہیں۔ LaTeX نوٹیشن میں ریاضی کے فارمولوں اور Mermaid خاکوں کو اپنا اپنا رینڈرر چاہیے، اور انہیں غلط رینڈر کرنا سورس دکھانے سے بدتر ہے — غلط رینڈر ہوئی مساوات ایسے طریقے سے غلط ہوتی ہے جو کسی کو نظر نہیں آتا۔ Markdown کے اندر خام HTML سادہ ان لائن فارمیٹنگ کے لیے سنبھالا جاتا ہے، لے آؤٹ کے لیے نہیں، کیونکہ صفحوں میں بٹی دستاویز میں مارک اپ کے کسی بھی بلاک کی جگہ نہیں۔

جب آپ کو کچھ اور چاہیے

اس کام کے لیے سنجیدہ ٹول Pandoc ہے اور یہ مفت ہے۔ pandoc doc.md -o doc.pdf --pdf-engine=xelatex LaTeX کے ذریعے ٹائپ سیٹ کرتا ہے، جو واقعی خوبصورت آؤٹ پٹ دیتا ہے — درست ہائفنیشن، ویڈو کنٹرول اور اصل فہرستِ مضامین کے ساتھ — اور ٹیمپلیٹ کے ذریعے آپ ڈیزائن کا ہر پہلو کنٹرول کرتے ہیں۔ یہ LaTeX ریاضی بھی درست رینڈر کرتا ہے، جو یہاں کی خاص کمی ہے۔ قیمت ایک TeX ڈسٹری بیوشن انسٹال کرنا ہے، جو چھوٹی نہیں۔

کسی ایک بار کی دستاویز کے بجائے ڈاکیومینٹیشن کے لیے، اسٹیٹک سائٹ جنریٹر یا mdBook PDF سے بہتر چیز بناتا ہے: تلاش کے قابل، لنک کے قابل، اور فون پر پڑھنے کے قابل۔ PDF میں تب تبدیل کریں جب دستاویز کو پرنٹ، اٹیچ یا آرکائیو کرنا ہو — اور دونوں صورتوں میں Markdown کو ہی اصل سورس رکھیں، کیونکہ وہی ورژن ایڈٹ اور ڈف کیا جا سکتا ہے۔