Markdown तालिकाएँ: पाइपों की गिनती के बजाय उन्हें उत्पन्न करें

एक उदाहरण में वाक्यविन्यास

                | Tool          | Input       | Offline |
| :------------ | :---------: | ------: |
| YAML to JSON  | YAML        | yes     |
| JWT decoder   | JWT         | yes     |
              

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

तीन चीजें जो मेजें तोड़ देती हैं

• एक सेल के अंदर एक पाइप - इसे `\|` के रूप में छोड़ दें, या पंक्ति एक कॉलम में बहुत अधिक विभाजित हो जाती है।
• स्तंभों की गलत संख्या वाली एक सीमांकक पंक्ति - हेडर शिफ्ट हो जाता है और तालिका गलत तरीके से प्रस्तुत होती है।
• तालिका के अंदर एक रिक्त रेखा - रेंडरर इसे तालिका के अंत के रूप में मानता है और बाकी को पाठ के रूप में प्रिंट करता है।

कोशिकाओं में कोड और रेगेक्स के लिए पलायन सबसे अधिक मायने रखता है: `a|b` और `\bfoo\b` दोनों को एक टेबल के अंदर खुशी से रहने से पहले ध्यान देने की आवश्यकता है।

स्प्रेडशीट से डेटा प्राप्त करना

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

टेबल का उपयोग कब नहीं करना चाहिए

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

जनरेट करें, फिर कहीं भी पेस्ट करें

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