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 को असली सोर्स बनाए रखें, क्योंकि वही वर्शन है जिसे एडिट किया और डिफ़ किया जा सकता है।