Markdown ڈویلپرز، مصنفین اور نوٹس ایپس کو یہ سہولت دیتا ہے کہ متن سادہ متن کے طور پر پڑھنے کے قابل رہے اور سرخیاں، فہرستیں اور زور بھی نشان زد ہوں۔ مگر زیادہ تر قارئین اسے فارمیٹ شدہ شکل میں نہیں کھول سکتے۔ Markdown سے PDF فائل کو Pandoc سے تبدیل کر کے اسٹائل والی دستاویز کی صورت میں بناتا ہے، تاکہ README، میٹنگ نوٹس کی فائل یا کوئی دستاویزی حصہ ایسی PDF بن جائے جو ہر کوئی پڑھ سکے۔
Markdown سے PDF استعمال کرنے کا طریقہ
- .md یا .markdown فائل شامل کریں۔
- PDF میں تبدیل کریں منتخب کریں۔
- PDF ڈاؤن لوڈ کریں۔
- نتیجے میں ٹیبلز، کوڈ بلاکس اور لنکس جانچیں۔
کیا فارمیٹ ہوتا ہے
Pandoc عام Markdown نحو سمجھتا ہے: سرخیاں، پیراگراف، بولڈ اور اٹالک متن، نمبر والی اور بغیر نمبر کی فہرستیں، اقتباسات، لنکس، افقی لکیریں، باڑ والے کوڈ بلاکس اور عمودی لکیر والی ٹیبلز۔ یہ انہیں HTML میں بدلتا ہے، جو پھر PDF صفحات پر ترتیب دی جاتی ہے، اور لنکس PDF میں کلک کے قابل رہتے ہیں۔ TeX میں لکھی ریاضیاتی علامات مساوات کی صورت میں نہیں بنتیں، اس لیے ریاضی پر بہت زیادہ منحصر دستاویزات کو مخصوص ٹائپ سیٹنگ ٹول درکار ہے۔
تصاویر، اور Pandoc کے بغیر سرورز
یہ ٹول ایک Markdown فائل تبدیل کرتا ہے، اس لیے نسبتی راستوں سے حوالہ دی گئی تصاویر دستیاب نہیں ہوتیں، اور ویب پتوں سے آنے والی تصاویر حفاظت کے لیے روک دی جاتی ہیں۔ اگر ڈایاگرامز درکار ہوں تو انہیں تصاویر سے PDF سے الگ تبدیل کریں۔ فارمیٹنگ سرور پر Pandoc انسٹال ہونے پر منحصر ہے؛ جہاں یہ نہ ہو وہاں بھی VelloDoc PDF تو بناتا ہے مگر Markdown کو اس کی علامتوں سمیت سادہ متن کے طور پر دکھاتا ہے۔
دستاویزات کا ورک فلو
Markdown سے PDF کوڈ ریپوزٹری سے باہر کے لوگوں، جیسے کلائنٹس، آڈیٹرز یا مینیجرز، کے ساتھ دستاویزات شیئر کرنے کے لیے موزوں ہے۔ کئی تبدیل شدہ فائلیں PDF فائلیں ملائیں سے ایک ہینڈ بک میں جوڑیں اور صفحات پر نمبر لگائیں سے صفحات پر نمبر لگائیں۔ بغیر ڈھانچے کے سادہ نوٹس کے لیے TXT سے PDF کافی ہے، اور PDF سے Markdown متن واپس نکالتا ہے۔ فارمیٹس کی گائیڈ فوائد اور نقصانات کی وضاحت کرتی ہے۔
Markdown سے PDF کب استعمال ہوتا ہے
غیر ڈویلپرز کے لیے README فائلیں
کلائنٹس یا مینیجرز کو ریپوزٹری کھنگالنے کا کہے بغیر کسی منصوبے کی README کی پڑھنے کے قابل PDF دیں۔
میٹنگ نوٹس اور روزنامچے
Markdown ایپس میں رکھے نوٹس کو ایسی دستاویزات میں بدلیں جنہیں آپ فائل، پرنٹ یا روداد کے طور پر ای میل کر سکیں۔
تکنیکی دستاویزات
سیٹ اپ گائیڈز اور آپریشنل ہدایات کو آڈٹ، حوالگی یا آف لائن حوالے کے لیے PDF فائلوں میں یکجا کریں۔
جاننے کے قابل حدود
Markdown سے PDF ایک وقت میں ایک فائل تبدیل کرتا ہے، اس لیے نسبتی تصاویر شامل نہیں ہوتیں اور دور کی تصاویر روک دی جاتی ہیں۔ TeX ریاضی ٹائپ سیٹ نہیں ہوتی۔ مکمل فارمیٹنگ کے لیے سرور پر Pandoc ضروری ہے؛ اس کے بغیر نتیجہ سادہ متن ہوتا ہے۔ WeasyPrint بھی ضروری ہے۔
Markdown سے PDF: عام سوالات
کون سا Markdown نحو سپورٹ ہوتا ہے؟
سرخیاں، زور، فہرستیں، اقتباسات، لنکس، باڑ والے کوڈ بلاکس، افقی لکیریں اور عمودی لکیر والی ٹیبلز سب Pandoc کے ذریعے سپورٹ ہوتی ہیں۔
میری تصاویر کیوں غائب ہیں؟
صرف Markdown فائل اپ لوڈ ہوتی ہے، اس لیے نسبتی راستوں والی تصاویر نہیں ملتیں، اور دور کی تصاویر روک دی جاتی ہیں۔ تصاویر الگ تبدیل کریں اور ضرورت ہو تو PDF فائلیں جوڑ دیں۔
میری PDF خام Markdown علامتیں کیوں دکھاتی ہے؟
سرور پر Pandoc انسٹال نہیں، اس لیے فائل سادہ متن کے طور پر بنی۔ Pandoc والا سرور فارمیٹ شدہ نتیجہ دیتا ہے۔
کیا کوڈ میں سنٹیکس ہائی لائٹنگ ہوتی ہے؟
کوڈ بلاکس اپنا مونو اسپیس لے آؤٹ اور سطروں کے وقفے برقرار رکھتے ہیں۔ رنگین ہائی لائٹنگ سرور کے Pandoc ورژن پر منحصر ہے، اس لیے کوڈ کا مطلب سمجھنے کے لیے اس پر انحصار نہ کریں۔