Markdown टेबल जनरेटर

Markdown टेबल असल में क्या है

Markdown टेबल मूल Markdown विनिर्देश का हिस्सा नहीं हैं; ये GitHub Flavored Markdown से आती हैं, वह बोली जिसे GitHub ने लोकप्रिय बनाया और जो अब लगभग हर जगह समर्थित है जहाँ डेवलपर लिखते हैं। सिंटैक्स जानबूझकर सादा टेक्स्ट है: कॉलम पाइप अक्षर से अलग किए जाते हैं, हेडर पंक्ति सबसे ऊपर बैठती है, और डैश की एक दूसरी पंक्ति हेडर को मुख्य भाग से अलग करती है। चूँकि यह बस टेक्स्ट है, एक Markdown टेबल अपने कच्चे रूप में पठनीय बनी रहती है और कॉपी-पेस्ट, वर्शन कंट्रोल के अंतर, और ईमेल में इस तरह बची रहती है जैसे कोई HTML टेबल कभी नहीं बच सकती।

यह टूल उन पाइपों को पंक्ति में लगाने की उकताहट को ख़त्म कर देता है। आप सामान्य पंक्तियाँ पेस्ट करते हैं, यह कॉलम का पता लगा लेता है, और हेडर, विभाजक पंक्ति, और हर सेल को अपनी जगह पर रखकर एक सही ढंग से बनी टेबल लिख देता है।

सिंटैक्स की संरचना

एक न्यूनतम टेबल तीन पंक्तियों जैसी दिखती है। पहली पंक्ति हेडरों को पाइप से अलग करके सूचीबद्ध करती है, उदाहरण के लिए Name फिर एक पाइप फिर Role। दूसरी पंक्ति विभाजक है: हर कॉलम के लिए डैश का एक समूह, जैसे तीन डैश, एक पाइप, तीन डैश। उसके बाद की हर पंक्ति उसी पाइप पैटर्न का उपयोग करने वाली एक डेटा पंक्ति है। हर पंक्ति के आरंभ और अंत में बाहरी पाइप GFM में वैकल्पिक हैं, पर इन्हें शामिल करने से कच्चा टेक्स्ट पढ़ने में आसान हो जाता है और यही जनरेटर तैयार करता है।

विभाजक पंक्ति दोहरा काम करती है: यह संकेत देती है कि ऊपर की पंक्ति एक हेडर है, और कोलन की जगह के ज़रिए यह घोषित करती है कि हर कॉलम कैसे संरेखित है। यही कारण है कि किसी Markdown टेबल को रेंडर होने के लिए हमेशा कम से कम एक हेडर और एक विभाजक पंक्ति चाहिए।

कॉलम संरेखण सेट करना

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

इस टूल में Left, Center, या Right चुनने से वे कोलन चिह्न आपके लिए पूरी टेबल में लिख दिए जाते हैं, जिसका अर्थ है कि संरेखण GitHub पर, दस्तावेज़ीकरण जनरेटरों में, और किसी भी अन्य GFM व्यूअर में एक जैसा रेंडर होता है, बजाय इसके कि यह पाठक की सेटिंग्स पर निर्भर रहे।

एक हल किया हुआ उदाहरण

तीन कॉमा-से-अलग की हुई पंक्तियाँ पेस्ट करें, सबसे ऊपर Name, Role, City और उसके बाद Ada Lovelace, Engineer, London और Grace Hopper, Admiral, New York। बीच का संरेखण चुने जाने पर, टूल तीन शीर्षकों की एक हेडर पंक्ति, एक विभाजक पंक्ति जहाँ हर कॉलम के डैश कोलन में लिपटे हों, और दो डेटा पंक्तियाँ देता है। GitHub पर किसी README में पेस्ट करने पर, यह मानों को बीच में संरेखित किए हुए एक सुथरी तीन-कॉलम वाली टेबल के रूप में रेंडर होती है, बिना किसी मैन्युअल पाइप-गिनती के।

पाइप को एस्केप करना और अन्य सावधानियाँ

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

दो और बातें जानने लायक़ हैं। Markdown टेबल किसी सेल के अंदर Enter कुंजी का उपयोग करके कठोर लाइन ब्रेक नहीं रख सकतीं; अगर आपको किसी सेल के भीतर एक ब्रेक चाहिए, तो आप एक स्पष्ट br टैग डालेंगे, क्योंकि GFM इनलाइन HTML की अनुमति देता है। और हर पंक्ति में हेडर के बराबर कॉलमों की संख्या होनी चाहिए। किसी पंक्ति में अतिरिक्त सेल अधिकांश रेंडरर अनदेखे कर देते हैं और छूटे हुए सेल खाली रेंडर होते हैं, इसलिए अनुमानित नतीजों के लिए अपनी पंक्तियों को आयताकार रखें।

विभाजक और उद्धरण में लिखे मान

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

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

Markdown टेबल कहाँ काम करती हैं, और कहाँ नहीं

Markdown टेबल डेवलपर और लेखन संदर्भों में चमकती हैं: GitHub और GitLab के README, इश्यू, और पुल रिक्वेस्ट; स्टैटिक-साइट और दस्तावेज़ीकरण जनरेटर; कई विकी और नोट ऐप; Slack और Discord जैसे चैट टूल अपने Markdown-समझने वाले फ़ील्ड में; और Reddit की टिप्पणियाँ। जहाँ भी GFM समर्थित है, एक पेस्ट की गई टेबल बस काम कर जाती है और स्रोत रूप में पठनीय बनी रहती है।

हालाँकि ये सार्वभौमिक नहीं हैं। GFM विस्तार के बिना सादा Markdown टेबलों को नहीं समझता, और कुछ हल्के रेंडरर इन्हें अनदेखा कर देते हैं, जिस स्थिति में कच्चे पाइप दिखाई देने लगते हैं। Markdown टेबलों में बारीक़ स्टाइलिंग नियंत्रण, मिले हुए सेल, और नेस्टेड संरचना की भी कमी होती है। जब आपको सटीक फ़ॉर्मेटिंग, colspan, या समृद्ध स्टाइलिंग चाहिए, तो एक HTML टेबल बेहतर चुनाव है; जब आप एक साफ़, वर्शन-नियंत्रण-योग्य, मानव-पठनीय टेबल चाहते हैं, तो Markdown जीतता है।