Markdown: यह डॉक्यूमेंटेशन का मानक क्यों बना

Markdown एक हल्की मार्कअप भाषा है जो आपको साधारण कैरेक्टर से टेक्स्ट फ़ॉर्मेट करने देती है — हेडिंग, लिस्ट, लिंक, एम्फ़सिस — जबकि यह अपने कच्चे रूप में भी पढ़ने योग्य रहती है, HTML के उलट जो बिना रेंडरिंग के पढ़ना मुश्किल है।

बुनियादी सिंटैक्स

• # हेडिंग — # कैरेक्टर की संख्या के हिसाब से अलग-अलग लेवल की हेडिंग।
• **बोल्ड** और *इटैलिक* — टेक्स्ट एम्फ़सिस।
• [टेक्स्ट](url) — एक लिंक।
• - आइटम या 1. आइटम — बुलेट और नंबर वाली लिस्ट।
• ``` — भाषा के नाम के आधार पर सिंटैक्स हाइलाइटिंग वाला कोड ब्लॉक।

देवनागरी में मोनोस्पेस कोड ब्लॉक क्यों अजीब दिखते हैं

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

Markdown मूल रूप से टेबल परिभाषित ही नहीं करता था

जॉन ग्रुबर ने 2004 में जो Markdown लिखा, वह गद्य में वर्णित था, औपचारिक व्याकरण नहीं — और उसमें टेबल, स्ट्राइकथ्रू या भाषा-हाइलाइटेड कोड ब्लॉक शामिल नहीं थे। 2014 में CommonMark ने इन अस्पष्टताओं को दूर करने के लिए एक सटीक व्याकरण तय किया, और GitHub Flavored Markdown (GFM) ने उसके ऊपर टेबल और टास्क लिस्ट जैसे एक्सटेंशन जोड़े, जो आज हर README में सामान्य लगते हैं।

HTML में और वापस कन्वर्ट करना

Markdown → HTML कन्वर्ज़न सीधा है: पार्सर सिंटैक्स कंस्ट्रक्ट पहचानता है और संबंधित टैग जेनरेट करता है। उल्टा कन्वर्ज़न, HTML → Markdown, ज़्यादा मुश्किल है, क्योंकि HTML बेसिक Markdown से कहीं ज़्यादा फ़ॉर्मेटिंग ऑप्शन सपोर्ट करता है, इसलिए कुछ मार्कअप (जटिल टेबल, नेस्टेड स्टाइल) सिंपलिफ़ाई या खो सकते हैं।

यह किस काम आता है

• बिना पब्लिश किए यह जल्दी देखना कि Markdown फ़ाइल कैसे रेंडर होगी।
• वर्शन कंट्रोल सिस्टम में स्टोर करने के लिए पेज या डॉक्यूमेंट कंटेंट को Markdown में कन्वर्ट करना।
• सिर्फ़ Markdown स्वीकार करने वाले ऐप में इंसर्शन के लिए HTML कंटेंट तैयार करना।