इस लेख में
Markdown वैलिडेशन क्या है?
Markdown वैलिडेशन यह जाँचता है कि आपका दस्तावेज़ सही सिंटैक्स का पालन करता है या नहीं और क्या यह अलग-अलग प्लेटफ़ॉर्म पर सही ढंग से रेंडर होगा। Markdown को सरल बनाया गया है, फिर भी अलग-अलग पार्सर के बीच का अंतर यह मायने रखता है कि फ़ॉर्मैटिंग की छोटी-सी चूक GitHub, GitLab और दूसरे टूल पर अलग-अलग नतीजे दे सकती है।
दस्तावेज़, README फ़ाइलें और तकनीकी गाइड अब बढ़-चढ़कर Markdown में लिखे जाते हैं। वैलिडेशन यह सुनिश्चित करता है कि जहाँ भी यह दिखे, वहाँ रेंडरिंग एक जैसी हो, हेडिंग की संरचना सही हो और फ़ॉर्मैटिंग साफ़-सुथरी हो।
Markdown वैलिडेटर कैसे काम करता है
CheckTown का Markdown वैलिडेटर आपके कंटेंट को पार्स करता है और फ़ॉर्मैटिंग की गलतियों तथा संरचनात्मक समस्याओं की जाँच करता है।
- सिंटैक्स की पुष्टि — हेडिंग स्तर, सूची फ़ॉर्मैटिंग, कोड ब्लॉक के सीमांक और लिंक सिंटैक्स की जाँच करता है
- संरचना का विश्लेषण — हेडिंग के क्रम की समस्याएँ पकड़ता है, जैसे बीच के स्तर छोड़ देना
- लिंक की जाँच — इनलाइन और रेफ़रेंस लिंक के सिंटैक्स को मिलते हुए ब्रैकेट और कोष्ठक के साथ वैलिडेट करता है
निःशुल्क आज़माएँ — कोई साइनअप आवश्यक नहीं
अपना Markdown वैलिडेट करें →आम Markdown गलतियाँ
Markdown की गलतियाँ बारीक होती हैं क्योंकि ये कोई एरर मैसेज नहीं देतीं — ये बस ग़लत ढंग से रेंडर हो जाती हैं।
- खाली पंक्तियाँ न होना — सही पार्सिंग के लिए Markdown को हेडिंग, सूचियों और कोड ब्लॉक से पहले खाली पंक्तियाँ चाहिए होती हैं
- असंगत सूची चिह्न — एक ही सूची में तारांकन, डैश और जोड़ चिह्न मिलाने से पार्सर भ्रमित हो सकते हैं
- टूटा हुआ लिंक सिंटैक्स — बंद करने वाला ब्रैकेट या कोष्ठक छूट जाने पर लिंक सादे टेक्स्ट में बदल जाता है
Markdown वैलिडेशन का उपयोग कब करें
Markdown वैलिडेशन तब सबसे उपयोगी होता है जब दस्तावेज़ों को कई प्लेटफ़ॉर्म पर सही ढंग से रेंडर होना ज़रूरी हो।
- दस्तावेज़ीकरण — GitHub पर सही प्रदर्शन सुनिश्चित करने के लिए पुश करने से पहले README फ़ाइलें वैलिडेट करें
- ब्लॉग कंटेंट — फ़ॉर्मैटिंग की समस्याएँ पकड़ने के लिए प्रकाशित करने से पहले Markdown पोस्ट जाँचें
- टीम मानक — CI पाइपलाइन के ज़रिए योगदानकर्ताओं में एक जैसी Markdown शैली लागू करें
अक्सर पूछे जाने वाले सवाल
वैलिडेटर किस Markdown विनिर्देश का उपयोग करता है?
यह वैलिडेटर CommonMark विनिर्देश का पालन करता है, जिसे GitHub, GitLab और अधिकांश आधुनिक पार्सर समर्थन करते हैं।
क्या वैलिडेटर GitHub Flavored Markdown का समर्थन करता है?
हाँ। यह वैलिडेटर GFM एक्सटेंशन को पहचानता है, जिनमें टेबल, टास्क लिस्ट, स्ट्राइकथ्रू और फ़ेंस्ड कोड ब्लॉक शामिल हैं।
क्या Markdown वैलिडेशन टूटे हुए लिंक पकड़ सकता है?
यह वैलिडेटर लिंक के सिंटैक्स की जाँच करता है, पर यह सत्यापित नहीं करता कि URL सचमुच खुलते हैं या नहीं। इसके लिए एक अलग लिंक चेकर की ज़रूरत होती है।