MD को PDF में बदलें

यही फ़र्क़ है साइट के हर दूसरे दस्तावेज़ बदलाव से। Word फ़ाइल अपना पन्ना आकार, हाशिया और फ़ॉन्ट जानती है; Markdown फ़ाइल इनमें से कुछ नहीं जानती, क्योंकि यह फ़ॉर्मेट जान-बूझकर बनावट रिकॉर्ड करता है और दिखावट जो भी रेंडर करे उस पर छोड़ देता है।

तो पन्ने का हर फ़ैसला — आकार, हाशिया, टाइपफ़ेस, कहाँ ब्रेक पड़े — कन्वर्टर करता है, और इनमें से कोई भी आपकी फ़ाइल में नहीं। यही Markdown का सौदा है, और आम तौर पर अच्छा है: वही दस्तावेज़ वेबपेज, स्लाइड डेक और PDF बन जाता है बिना दोबारा लिखे। क़ीमत यहाँ दिखती है, क्योंकि जिस कन्वर्टर को Markdown पढ़ना नहीं सिखाया गया उसके पास रेंडर करने को कुछ नहीं, तो वह अक्षर सेट करने पर वापस लौट आता है।

फ़ाइल का हर अक्षर पन्ने पर आता है, क्रम में, एक ही टाइपफ़ेस में। "## Requirements" लिखी लाइन "## Requirements" ही सेट होती है। हाइफ़न से लिखा bullet हाइफ़न से शुरू होने वाली लाइन है। Fenced block अपने ऊपर-नीचे तीन backtick रखता है। Bold अपने चार asterisk रखता है। कुछ भी छूटता नहीं और कुछ भी समझा नहीं जाता, क्योंकि इस जोड़ी के पीछे का इंजन टेक्स्ट पढ़ता है और इसे कभी Markdown फ़िल्टर नहीं दिया गया।

जो बचता है वह जानना ज़रूरी है। Line break, ख़ाली लाइन और इंडेंटेशन ठीक-ठीक बचते हैं, तो जिस दस्तावेज़ की क़ीमत उसके कमांड और configuration में है वह काम की चीज़ में बदलता है। जिस दस्तावेज़ की क़ीमत उसकी heading बनावट में है वह नहीं बदलता, और वहाँ जवाब है Markdown को उसी टूल में रेंडर करना जिसमें लिखा था, फिर वहाँ से PDF प्रिंट करना।

छह डायग्राम दिखाने वाले Markdown दस्तावेज़ में कोई डायग्राम नहीं होता। इसमें छह पथ होते हैं, और तस्वीरें उसके साथ डिस्क या सर्वर पर रहती हैं। यह पहली बार बदलने वालों को चौंकाता है, और यही सबसे आम वजह है जिससे PDF में ख़ाली जगह आती है।

हल यह है कि बदलने से पहले पथ काम करें यह पक्का कीजिए। Relative पथ ऐसी फ़ाइलों की तरफ़ इशारा करने चाहिए जो सच में दस्तावेज़ के साथ हैं; पूर्ण वेब पते उस सर्वर के पहुँच में होने पर निर्भर हैं।

बहुत-सी Markdown फ़ाइलें तीन हाइफ़न से घिरे ब्लॉक से शुरू होती हैं जिसमें टाइटल, तारीख़ और कुछ टैग होते हैं। Static-site generator, documentation builder और नोट ऐप इसे मेटाडेटा मानकर कुछ भी रेंडर करने से पहले हटा देते हैं।

यह बदलाव उस रिवाज़ को नहीं जानता और उस ब्लॉक को बाक़ी सब की तरह छाप देता है, तो PDF तीन हाइफ़न और कुंजी-मान जोड़ों की सूची से शुरू होता है। बदलने से पहले वह ब्लॉक मिटाना ही पूरा हल है।

2004 में Markdown का मूल विवरण अनौपचारिक था, CommonMark वह सटीक स्पेसिफ़िकेशन है जिसे ज़्यादातर टूल मानते हैं, और pipe table, task list, footnote व strikethrough जो सब इस्तेमाल करते हैं वे इसके ऊपर बने विस्तार हैं। कोई टूल इनमें से कौन-सा लागू करता है, यह आम तौर पर तय करता है दस्तावेज़ कैसा निकलेगा।

यह पेज पर सवाल नहीं है। यहाँ इनमें से कुछ भी लागू नहीं, मूल भी नहीं, तो GitHub table और CommonMark heading को एक जैसा माना जाता है — टेक्स्ट की लाइनों के तौर पर। यह कम से कम अंदाज़ा लगाने लायक़ है: कोई शैली अंदाज़ा लगाने की नहीं, कोई रेंडरर जाँचने का नहीं।

क्योंकि पढ़ने वाला आप नहीं। किसी क्लाइंट, वकील, समिति या compliance अधिकारी को ऐसा दस्तावेज़ चाहिए जो वह खोल सके, प्रिंट कर सके, दस्तख़त कर सके और फ़ाइल कर सके — ऐसी फ़ाइल नहीं जिसे उसकी मशीन कोड एडिटर में खोलने का सुझाव दे। हैश साथ जाते हैं, तो यह एक तय प्रति है, प्रस्तुत करने लायक़ नहीं।

PDF हालत को भी जमा देता है। README हर हफ़्ते बदलती है; उसकी PDF वह है जो उस दिन सच थी जिस दिन किसी चीज़ के साथ जोड़ी गई — जो ठीक वही है जो समीक्षा, प्रस्तुति या अनुबंध परिशिष्ट को चाहिए। Markdown में लिखते रहिए और जब बाहर किसी को प्रति चाहिए तभी एक्सपोर्ट कीजिए।

HTML तब जब गंतव्य वेबपेज या documentation साइट है, क्योंकि Markdown उसी के लिए संक्षिप्त रूप बनाया गया था और यह बदलाव रेंडरिंग से ज़्यादा अनुवाद के क़रीब है।

DOCX एक ख़ास और आम हालत में: प्राप्तकर्ता सिर्फ़ Word फ़ाइल स्वीकारेगा और tracked changes जोड़ना चाहता है। Markdown में कोई समीक्षा वर्कफ़्लो नहीं, तो टिप्पणियों के दौर में जाने वाला दस्तावेज़ DOCX के तौर पर सौंपना बेहतर है — और PDF उस संस्करण के लिए है जो पूरा हो चुका है।

यह बदलाव ब्राउज़र में नहीं चलता, क्योंकि इसे असली दस्तावेज़ इंजन चाहिए। फ़ाइल एन्क्रिप्टेड कनेक्शन से भेजी जाती है, अलग वातावरण में बदली जाती है, और काम पूरा होते ही मिटा दी जाती है — मुफ़्त स्तर प्रति फ़ाइल 25 MB स्वीकारता है, जो किसी भी सामान्य README या नोट के लिए काफ़ी है।

अगर Markdown में संवेदनशील जानकारी है — आंतरिक दस्तावेज़, ग्राहक नोट, अप्रकाशित मसौदा — यह जानना ज़रूरी है कि फ़ाइल कहाँ जा रही है, चाहे वह कितनी भी संक्षिप्त क्यों न हो। यह पेज इसे छुपाता नहीं; यही वजह है यहाँ साफ़ लिखा है कि बदलाव कहाँ चलता है।