Markdown से PDF

Markdown लिखने का फ़ॉर्मैट है, जानबूझकर सादे टेक्स्ट के क़रीब: किसी भी एडिटर में पढ़ा जा सकता है, वर्ज़न कंट्रोल में उसका अंतर देखा जा सकता है, और उसमें वह अदृश्य अवस्था नहीं होती जो वर्ड प्रोसेसर की फ़ाइलों पर मिलकर काम करना मुश्किल बना देती है। जो वह नहीं है, वह है पहुँचाने का फ़ॉर्मैट। जिस व्यक्ति को इसकी आदत नहीं, उसके हाथ में .md फ़ाइल देना उसे हैश और तारांकनों से भरी एक टेक्स्ट फ़ाइल थमाना है।

PDF इसकी पूरक है। वह रूप को स्थिर कर देती है, सामग्री को पन्नों में बाँटती है, बिना किसी एडिटर या रेंडरर के हर जगह खुल जाती है, और ठीक से छपती है। Markdown में लिखना और PDF में पहुँचाना दोनों फ़ायदे देता है: ऐसा स्रोत जिसे आप रिपॉज़िटरी में रख सकें और टेक्स्ट की तरह जाँच सकें, और ऐसी चीज़ जिसे कोई भी पढ़ सके।

आम मामले हैं क्लाइंट को दिया जाने वाला दस्तावेज़ीकरण, छापने लायक संदर्भ में बदला गया README, किसी बैठक के लिए तकनीकी नोट, और वह शैक्षणिक या निजी लेखन जो सादे टेक्स्ट में लिखा गया और दस्तावेज़ के रूप में जमा किया जाना है।

Markdown से PDF बनाने के दो तरीक़े हैं और वे बहुत अलग फ़ाइलें बनाते हैं। शॉर्टकट यह है कि Markdown को वेब पेज की तरह रेंडर करके उसकी तस्वीर खींच ली जाए — यह तेज़ है और ऐसा दस्तावेज़ देता है जो तस्वीरों से बना है: न खोजा जा सकने वाला, न कॉपी होने वाला, स्क्रीन रीडर के लिए अदृश्य, और जिस नाप पर खींचा गया उसके अलावा किसी भी नाप पर छापने पर धुँधला।

दूसरा तरीक़ा सामग्री को एक असली पेज पर सजाता है: एम्बेडेड फ़ॉन्ट से चुने हुए नाप पर बनाया गया टेक्स्ट, तय चौड़ाई में बहते पैराग्राफ़, और ब्लॉक के आर-पार जाने के बजाय उनके बीच रखे गए पेज ब्रेक। यहाँ यही होता है, और इसीलिए नतीजा तस्वीरों की स्लाइड-शो के बजाय एक दस्तावेज़ जैसा बरताव करता है।

फ़र्क़ उन्हीं रोज़मर्रा के कामों में दिखता है जो लोग PDF के साथ बाद में करते हैं। किसी शब्द को खोजना काम करता है। कोई कोड स्निपेट कॉपी करने पर कोड ही मिलता है। A4 के लिए सजे दस्तावेज़ को A4 पर छापने से किसी भी ज़ूम पर साफ़ टाइप मिलता है।

शीर्षक सिर्फ़ मोटे टेक्स्ट के बजाय नाप का एक असली क्रम बनते हैं, जिससे दस्तावेज़ में दिखने वाला ढाँचा आ जाता है। ज़ोर तिरछे और मोटे रूप में रेंडर होता है। क्रम वाली और बिना क्रम वाली सूचियाँ ठीक से एक-दूसरे के भीतर बैठती हैं, और उनकी हाशिया-दूरी से स्तर साफ़ पढ़े जाते हैं। उद्धरण मुख्य इबारत से अलग दिखाए जाते हैं, और आड़ी रेखाएँ रेखाएँ ही बनती हैं।

कोड को सबसे ज़्यादा एहतियात से सँभाला जाता है, क्योंकि वही सबसे कम माफ़ करता है। इनलाइन कोड एक समान-चौड़ाई वाले फ़ॉन्ट में रखा जाता है, ताकि वाक्य के बीच भी कोड की तरह पढ़ा जाए; बाड़ लगे ब्लॉक अपनी ख़ाली जगह हूबहू बनाए रखते हैं और दोबारा नहीं बहाए जाते, क्योंकि ज़्यादातर भाषाओं में हाशिया-दूरी का अर्थ होता है। छपी हुई लिस्टिंग में एक ही चीज़ जाँचने लायक है — लाइन की चौड़ाई, क्योंकि पेज बग़ल में खिसक नहीं सकता।

टेबल पंक्तिबद्ध कॉलम और असली सेल सीमाओं के साथ रेंडर होती हैं। लिंक अपना टेक्स्ट बनाए रखते हैं और लिंक के रूप में दिखते रहते हैं। स्रोत में जिन तस्वीरों का हवाला है, वे इबारत के बीच ऐसे नाप पर रखी जाती हैं जो पेज में समा जाए।

कुछ आदतें किसी भी सेटिंग से ज़्यादा नतीजा सुधारती हैं। एक ही सबसे ऊपरी शीर्षक इस्तेमाल कीजिए और उसके नीचे लगातार क्रम में घोंसला बनाइए — जो दस्तावेज़ पहले स्तर के शीर्षक से सीधे तीसरे स्तर पर कूद जाता है, वह पेज पर टूटा हुआ क्रम बनाता है, भले ही ब्राउज़र में ठीक-ठाक रेंडर हो।

जहाँ लिस्टिंग मायने रखती है वहाँ कोड की लाइनें क़रीब अस्सी वर्णों के भीतर रखिए, क्योंकि समान-चौड़ाई वाले फ़ॉन्ट में पोर्ट्रेट पेज पर आराम से इतना ही समाता है। लंबी टेबल को कॉलम दबाकर सिकोड़ने देने के बजाय दो पतली टेबल में बाँट देना बेहतर है।

जिन दस्तावेज़ों में गणित, आरेख या लिखते वक़्त लाइव प्रीव्यू चाहिए, उनके लिए Markdown एडिटर शुरुआत की बेहतर जगह है — वह LaTeX और Mermaid दोनों रेंडर करता है, अपने-आप सहेजता है, और PDF, Word तथा HTML में निर्यात करता है। जहाँ पाने वाले को पढ़ना नहीं, बदलना है, वहाँ Markdown से Word सही रास्ता है।