YAML को JSON में बदलना YAML Ain't Markup Language ↔ JavaScript Object Notation मुफ़्त ऑनलाइन सुरक्षित
एक YAML फ़ाइल छोड़िए और JSON ले जाइए। पढ़ना और लिखना यहीं, आपके ब्राउज़र में होता है, सो फ़ाइल आपके उपकरण से बाहर नहीं जाती — और यह यात्रा क्या बचाती है और क्या नहीं, वह नीचे लिखा है, आपके ख़ुद पता लगाने पर नहीं छोड़ा गया।
अपनी फ़ाइल बदलिए
यहाँ एक YAML फ़ाइल छोड़िए, या कोई चुनिए।
आपकी फ़ाइल इस उपकरण से बाहर नहीं जाती। सब कुछ आपके ब्राउज़र में चलता है।
कुछ भी अपलोड नहीं
YAML से रूपांतरण
YAML में रूपांतरण
ये प्रारूप कहाँ से आए
CSV सबसे पुराना और सबसे कम मानकीकृत है: एक सारणी जो पाठ की पंक्तियों के रूप में लिखी जाती है, 1970 के दशक से प्रयोग में और लिखित रूप में वर्णित हुआ केवल 2005 में, जब तक हर प्रोग्राम स्वयं तय कर चुका था कि विभाजक क्या है और उद्धरण-चिह्न कब लगाने हैं। XML 1998 में SGML से उपजा, उन दस्तावेज़ों के लिए जिन्हें कठोर संरचना ढोनी हो और किसी ढाँचे के विरुद्ध जाँचा जाना हो। JSON को डगलस क्रॉकफ़ोर्ड ने 2001 के आसपास जावास्क्रिप्ट से निकाला, जानबूझकर उसे वस्तुओं, सूचियों, संख्याओं और शब्द-लड़ियों तक घटा दिया — और वही न्यूनतावाद उसके वेब पर छा जाने का कारण है। YAML उसका पठनीय चचेरा भाई है, जहाँ अंतराल वह काम करता है जो अन्यत्र कोष्ठक करते हैं। इनके बीच रूपांतरण में केवल एक बात मायने रखती है: CSV चपटा है, पंक्तियों और स्तंभों की जाली; जबकि JSON, XML और YAML वृक्ष हैं।
ये आपको कहाँ मिलते हैं
CSV वह है जो स्प्रेडशीट निर्यात करती है और जो कोई लेखाकार, कोई दुकान का मंच या बैंक का विवरण आपको थमाता है। JSON वह है जो वेब की सेवाएँ आपस में बोलती हैं और जिसमें विन्यास-फ़ाइलें बढ़ते क्रम में लिखी जाती हैं। XML पुराने संस्थागत तंत्रों में, बीजक के मानकों में, और स्वयं कार्यालयी प्रारूपों के भीतर जीवित है। YAML वह जगह है जहाँ मनुष्य हाथ से सेटिंग लिखते हैं। इनके बीच रूपांतरण वह दैनिक काम है जो आँकड़ों को उनके उद्गम से वहाँ ले जाता है जहाँ उनकी आवश्यकता है।
अक्सर पूछे जाने वाले प्रश्न
मेरी CSV एक्सेल में एक ही स्तंभ के रूप में खुली। क्यों?
क्योंकि आपकी स्प्रेडशीट किसी और विभाजक की प्रतीक्षा में थी। एक्सेल कंप्यूटर की क्षेत्रीय सेटिंग के सूची-विभाजक का अनुसरण करता है, और वह हर उस जगह अर्धविराम है जहाँ अल्पविराम पहले से दशमलव चिह्न है — अर्थात महाद्वीपीय यूरोप के बड़े भाग में। तब अल्पविराम से विभाजित फ़ाइल पाठ के एक स्तंभ जैसी दिखती है। फ़ाइल पर दो बार क्लिक करने के बजाय आयात-खिड़की का उपयोग करें और विभाजक स्पष्ट बताएँ। इसी क्षेत्रीय सेटिंग से यह भी होता है कि 3.5 कभी तिथि बनकर आ जाता है।
मेरा नेस्ट किया JSON साफ़-सुथरी स्प्रेडशीट क्यों नहीं बनता?
क्योंकि स्प्रेडशीट चपटी है और JSON एक वृक्ष। एक पंक्ति हर स्तंभ के लिए एक मान रखती है; जबकि JSON की एक वस्तु किसी क्षेत्र के भीतर की सूची के भीतर एक और सूची रख सकती है। रूपांतरण का अर्थ है यह चुनना कि उसे कैसे चपटा किया जाए: या तो नेस्ट किए नामों को जोड़कर एक लंबा स्तंभ-शीर्षक बना दें, या जनक पंक्ति को हर संतान के लिए एक बार दोहरा दें। दोनों समझौते हैं, और कोई भी स्वतः पूर्ववत नहीं हो सकता — इसीलिए स्प्रेडशीट से मूल आकृति की ओर लौटने के लिए प्रायः मानवीय निर्णय चाहिए।
क्या फ़ाइल की गुणवत्ता घटती है?
यह इस पर निर्भर है कि दोनों प्रारूप क्या-क्या सँभाल सकते हैं। ऐसे प्रारूपों के बीच रूपांतरण जो एक ही वस्तु रखते हैं — PNG से BMP, WAV से FLAC — कुछ नहीं खोता। ऐसे प्रारूप में बदलना जो स्थान बचाने के लिए सूचना फेंक देता है, जैसे JPEG या MP3, हर बार थोड़ा खोता है, और वापस बदलने से वह लौटता नहीं। जहाँ विकल्प हो, यह पृष्ठ सबसे छोटी फ़ाइल बनाने के बजाय मूल गुणवत्ता बनाए रखने की ओर झुकता है।
क्या मेरी फ़ाइल कहीं अपलोड होती है?
नहीं। रूपांतरण आपके ही यंत्र पर, आपके ब्राउज़र के भीतर होता है; फ़ाइल उसे कभी नहीं छोड़ती, और यहाँ कोई सर्वर है ही नहीं जो उसे ले सके। इसीलिए बड़ी फ़ाइल को अपलोड नहीं बल्कि आपकी अपनी स्मृति सीमित करती है, और इसीलिए आपका बदला हुआ कुछ भी किसी के अभिलेख में नहीं आ सकता — हमारे अभिलेख में भी नहीं। हाँ, ध्वनि और चलचित्र के उपकरण पहली बार प्रयोग पर अपना रूपांतरण-इंजन इसी स्थल से लाते हैं — लगभग तीस मेगाबाइट, एक ही बार; उसके बाद भी काम पूरा आपके ही यंत्र पर होता है।
लोग YAML को JSON में क्यों बदलते हैं
YAML वह संकेतन है जिसे लोग तब चुनते हैं जब उन्हें डेटा हाथ से लिखना होता है। वह कोष्ठकों के बजाय इंडेंटेशन उपयोग करता है, टिप्पणियों की अनुमति देता है और लगभग रूपरेखा की तरह पढ़ता है, इसीलिए वह कॉन्फ़िगरेशन के लिए पसंदीदा बना: बिल्ड पाइपलाइन, कंटेनर परिभाषाएँ, परिनियोजन फ़ाइलें, स्थिर साइट सेटिंग, दस्तावेज़ीकरण उपकरण और असंख्य ऐप कॉन्फ़िगरेशन। JSON वह संकेतन है जिसे प्रोग्राम पाना पसंद करते हैं। वह कठोर है, उसमें टिप्पणियाँ नहीं, और हर प्रोग्रामिंग भाषा उसे मानक लाइब्रेरी से पढ़ सकती है। जब मनुष्यों के लिए लिखी फ़ाइल किसी ऐसे प्रोग्राम, API या उपकरण को सौंपनी हो जो केवल JSON स्वीकार करता है, तो रूपांतरण चाहिए। इसीलिए लोग YAML को JSON में बदलते हैं: उनके पास डेटा उस रूप में है जो लिखने में सुखद है, और गंतव्य वह रूप चाहता है जो पार्स करने में आसान है।
स्थितियाँ रोज़मर्रा की हैं। डेवलपर जो कॉन्फ़िगरेशन YAML में रखता है और उसे किसी सेवा को JSON के रूप में भेजना है। टीम जो सेटिंग फ़ाइल को JSON जाँचने वाले उपकरण से वैध कराना चाहती है। लेखक जिसके पास YAML में फ्रंट मैटर है और वह उसे स्क्रिप्ट को खिलाना चाहता है। विद्यार्थी जो देखना चाहता है कि YAML फ़ाइल का इंडेंटेशन कोष्ठकों से कैसे मेल खाता है। हर मामले में डेटा वही है, और केवल संकेतन बदलता है।
यह पृष्ठ आपके ब्राउज़र में YAML को JSON में बदलता है। आपकी फ़ाइल यहीं पढ़ी और लिखी जाती है, इसलिए वह आपके उपकरण से कभी बाहर नहीं जाती, जो कॉन्फ़िगरेशन फ़ाइलों के लिए मायने रखता है, जो अक्सर पते, आंतरिक प्रणालियों के नाम और कभी रहस्य रखती हैं। और पृष्ठ आपको पहले से बताता है कि पार करना क्या रखता है और क्या नहीं रख सकता, आपको खोजने के लिए छोड़ने के बजाय। नीचे आपको मिलेगा कि रूपांतरण कैसे काम करता है, टिप्पणियों के साथ क्या खोता है और तारीख़ों व टैगों से क्या अपेक्षा रखें।
रूपांतरण कैसे काम करता है
दोनों संकेतनों में वही आकार
आपका YAML आपके ब्राउज़र के भीतर पढ़ा जाता है, और उसकी संरचना JSON के रूप में लिखी जाती है। दोनों वही आकार रखते हैं: मैप, सूचियाँ, स्ट्रिंग, संख्याएँ, बूलियन और null बिना हानि के पार जाते हैं। YAML में मैपिंग JSON में ऑब्जेक्ट बनती है, अनुक्रम ऐरे बनता है, और अदिश मान अपने प्रकार रखते हैं। port: 8080 जैसी पंक्ति संख्या देती है, और enabled: true बूलियन।
ऐंकर और उपनाम फैलाए जाते हैं
YAML में एक सुविधा है जो JSON में नहीं: आप किसी ब्लॉक को ऐंकर से चिह्नित कर सकते हैं और अन्यत्र उपनाम से उसका संदर्भ दे सकते हैं, ख़ुद को दोहराने से बचने के लिए। ऐंकर और उपनाम फैलाए जाते हैं, इसलिए परिणाम अपने पैरों पर खड़ा है। जहाँ-जहाँ उपनाम आया था वहाँ अब ब्लॉक की पूरी प्रति है। JSON लंबा है, पर उसे पढ़ने के लिए ऐंकरों का ज्ञान नहीं चाहिए।
इंडेंटेशन संरचना बन जाता है
YAML में संरचना इंडेंटेशन से व्यक्त होती है। JSON में कोष्ठकों से। कन्वर्टर इंडेंटेशन को वैसे पढ़ता है जैसा लेखक का आशय था, और आपके लिए कोष्ठक लिखता है। इंडेंटेशन की ग़लतियाँ, जो सबसे आम YAML त्रुटियाँ हैं, अनुमान लगाने के बजाय रिपोर्ट की जाती हैं।
क्या रखा जाता है
वह सब जो डेटा है
सब कुछ रखा जाता है, क्योंकि दोनों वही आकार रखते हैं: मैप, सूचियाँ, स्ट्रिंग, संख्याएँ, बूलियन और null बिना हानि के पार जाते हैं। अगर वह आपके YAML में मान था, तो JSON में भी मान है।
कुंजियों का क्रम
कुंजियाँ वह क्रम रखती हैं जिसमें वे लिखी गईं, इसलिए JSON YAML के उसी क्रम में पढ़ता है।
बहु-पंक्ति स्ट्रिंग
YAML में कई पंक्तियों में फैली, ब्लॉक शैलियों से लिखी स्ट्रिंग, भीतर पंक्ति विराम वाली एकल स्ट्रिंग के रूप में ले जाई जाती हैं, जिन्हें JSON एस्केप अनुक्रम के रूप में लिखता है। पाठ वही है।
YAML को JSON में बदलने से पहले आपको क्या जानना चाहिए
टिप्पणियाँ और लेआउट चले जाते हैं
टिप्पणियाँ, ख़ाली पंक्तियाँ और उद्धृत व सादे के बीच का चुनाव YAML फ़ाइल के पढ़ने का ढंग हैं, उसका अर्थ नहीं, और इनमें से कोई नहीं बचता, क्योंकि JSON के पास उन्हें रखने की जगह नहीं। अगर आपका YAML व्याख्यात्मक टिप्पणियों से भरा है, तो JSON में उनमें से कोई नहीं होगी। YAML को वह फ़ाइल रखिए जिसे लोग पढ़ते और संपादित करते हैं, और JSON को व्युत्पन्न प्रति मानिए।
बिना उद्धरण की तारीख़ें पाठ के रूप में पहुँचती हैं
बिना उद्धरण के लिखी तारीख़ पाठ के रूप में पहुँचती है, क्योंकि JSON में तारीख़ नहीं। released: 2026-03-14 जैसी पंक्ति स्ट्रिंग 2026-03-14 देती है। JSON पढ़ने वाले प्रोग्राम को, अगर उसे तारीख़ चाहिए, उसे तारीख़ के रूप में व्याख्यायित करना चाहिए।
कस्टम टैगों का सम्मान नहीं होता
कस्टम टैगों का सम्मान नहीं होता: केवल मानक प्रकार पढ़े जाते हैं, जो फ़ाइल को ऐसी चीज़ माँगने से भी रोकता है जो इस पृष्ठ के पास नहीं। YAML ऐसे टैगों की अनुमति देता है जो किसी विशेष प्रोग्राम को किसी विशेष ऑब्जेक्ट को बनाने को कहते हैं। ऐसे निर्देश यहाँ कुछ अर्थ नहीं रखते, और कन्वर्टर उनका पालन नहीं करता।
यहाँ YAML को JSON में कैसे बदलें
अपनी फ़ाइल जोड़िए
YAML फ़ाइल को पृष्ठ पर छोड़िए या अपने उपकरण से चुनिए। वह आपके ब्राउज़र के भीतर पढ़ी जाती है और अपलोड नहीं होती।
बदलिए
बटन दबाइए। साधारण आकार की फ़ाइल में एक पल लगता है। पूरा होने तक पृष्ठ खुला रखिए।
डाउनलोड कीजिए और जाँचिए
JSON डाउनलोड कीजिए और टेक्स्ट एडिटर में खोलिए। शुरुआत और अंत देखिए, और जाँचिए कि संरचना और प्रकार वैसे हैं जैसी आप अपेक्षा रखते हैं।
YAML और JSON पर क़रीबी नज़र
उसी डेटा के दो संकेतन
YAML को मनुष्यों के लिए लिखने-पढ़ने में आसान होने के लिए बनाया गया था। JSON को प्रोग्रामों के लिए पढ़ने-लिखने में आसान होने के लिए। वे इतने दूर तक मेल खाते हैं कि JSON लगभग YAML का उपसमुच्चय है, और YAML पाठक आमतौर पर JSON पढ़ सकता है। उलटा सच नहीं, क्योंकि YAML में अधिक सुविधाएँ हैं। YAML को JSON में बदलना समृद्ध संकेतन से कठोर में जाना है, और अतिरिक्त चीज़ें छोड़ना है: टिप्पणियाँ, ऐंकर और टैग।
इंडेंटेशन की ग़लतियाँ क्यों मायने रखती हैं
क्योंकि YAML इंडेंटेशन पर निर्भर करता है, बेमेल पंक्ति अर्थ बदल देती है, और कभी वह फिर भी पार्स होती है। जो कुंजी ब्लॉक के भीतर होनी थी वह उसके बाहर पहुँच जाती है। JSON ऐसी ग़लतियाँ दिखा देता है, क्योंकि कोष्ठक ठीक बताते हैं कि हर कुंजी कहाँ उतरी। इसलिए बदलना यह जाँचने का सुविधाजनक तरीक़ा भी है कि फ़ाइल वही कहती है जो आप सोचते हैं।
टैब
YAML इंडेंटेशन के लिए टैब की अनुमति नहीं देता। अगर आपकी फ़ाइल में वे हैं, तो रूपांतरण समस्या रिपोर्ट करेगा। टैब को स्पेस से बदलिए और फिर कोशिश कीजिए।
आम स्थितियाँ विस्तार से
सेवाओं और उपकरणों के लिए कॉन्फ़िगरेशन
कई उपकरण केवल JSON में कॉन्फ़िगरेशन स्वीकार करते हैं, या उसे JSON स्कीमा से वैध कराते हैं। अपना YAML बदलिए और परिणाम वहाँ उपयोग कीजिए जहाँ JSON चाहिए।
जाँचना कि फ़ाइल वास्तव में क्या कहती है
जब YAML कॉन्फ़िगरेशन अजीब व्यवहार करे, तो उसे JSON में बदलना संरचना को असंदिग्ध रूप से दिखाता है। ग़लत जगह की कुंजियाँ और ग़लत प्रकार उभर आते हैं।
स्क्रिप्ट और API को खिलाना
JSON बॉडी लेने वाले API को रूपांतरण के बाद YAML फ़ाइल की सामग्री दी जा सकती है। यह आपको फ़ाइल उस रूप में रखने देता है जिसमें आपको संपादित करना पसंद है।
दस्तावेज़ीकरण और सामग्री फ़ाइलें
स्थिर साइट जनरेटर और दस्तावेज़ीकरण उपकरण फ्रंट मैटर और डेटा फ़ाइलों के लिए YAML उपयोग करते हैं। उन्हें बदलना अन्य उपकरणों को वही डेटा पढ़ने देता है।
YAML को JSON में बदलने से पहले व्यावहारिक सलाह
इंडेंटेशन जाँचिए
टैब नहीं, स्पेस उपयोग कीजिए, और हर स्तर पर वही चौड़ाई रखिए। अधिकांश एडिटर रिक्त स्थान दिखा सकते हैं और YAML त्रुटियाँ उभार सकते हैं।
जो मान पाठ रहने चाहिए उन्हें उद्धृत कीजिए
yes, no या 1.0 जैसा सादा मान बूलियन या संख्या के रूप में पढ़ा जा सकता है। अगर आपका आशय पाठ है, तो उसके चारों ओर उद्धरण लगाइए। यह संस्करण संख्याओं, कोडों और देश संक्षेपों की रक्षा करता है।
टिप्पणियाँ YAML में रखिए
क्योंकि टिप्पणियाँ नहीं बचतीं, YAML को उसके स्पष्टीकरणों के साथ मास्टर रखिए, और ज़रूरत पड़ने पर JSON फिर बनाइए।
बड़ी फ़ाइलें
सब कुछ आपके उपकरण पर चलता है, इसलिए बहुत बड़ी फ़ाइल को मेमोरी चाहिए। कई मेगाबाइट की फ़ाइलों के लिए कंप्यूटर उपयोग कीजिए, और अगर पृष्ठ जूझे तो डेटा बाँट दीजिए।
रूपांतरण से पहले लोग जो पूछते हैं
मेरी टिप्पणियाँ कहाँ गईं?
चली गईं। JSON के पास टिप्पणियाँ रखने की जगह नहीं, और वे फ़ाइल के पढ़ने का ढंग हैं, उसका अर्थ नहीं।
मेरी तारीख़ स्ट्रिंग क्यों है?
क्योंकि JSON में तारीख़ नहीं। बिना उद्धरण के लिखी तारीख़ पाठ के रूप में पहुँचती है।
ऐंकर और उपनामों का क्या होता है?
वे फैलाए जाते हैं, इसलिए परिणाम अपने पैरों पर खड़ा है।
मेरा टैग काम क्यों नहीं आया?
कस्टम टैगों का सम्मान नहीं होता। केवल मानक प्रकार पढ़े जाते हैं।
क्या मेरी फ़ाइल अपलोड होती है?
नहीं। रूपांतरण आपके ब्राउज़र में चलता है और फ़ाइल आपके उपकरण से कभी बाहर नहीं जाती।
क्या मैं YAML में वापस जा सकता हूँ?
हाँ। JSON से YAML डेटा को पठनीय रूप में वापस लिखता है, हालाँकि मूल की टिप्पणियों के बिना।
YAML को JSON में बदलते समय समझदारी से चुनाव
क्या JSON सचमुच ज़रूरी है?
अगर प्राप्त करने वाला उपकरण YAML पढ़ता है, तो YAML रखिए। केवल तब बदलिए जब JSON ज़रूरी हो।
अन्य लक्ष्य
अगर गंतव्य मार्कअप फ़ाइल है, तो JSON से XML आगे आ सकता है। तालिकाओं के लिए JSON से CSV और JSON से XLSX स्प्रेडशीटों की सेवा करते हैं।
YAML रखिए
YAML मास्टर है, अपनी टिप्पणियों और लेआउट के साथ। उसे रखिए, और JSON को प्रति मानिए।
रूपांतरण के बाद अच्छा परिणाम पाना
JSON को दर्शक में जाँचिए
परिणाम को ऐसे एडिटर में खोलिए जो JSON समझता है और ऑब्जेक्ट समेटिए। अगर संरचना वैसी दिखे जैसी आप अपेक्षा रखते हैं, तो वह ठोस है।
प्रकार जाँचिए
संस्करण, कोड और झंडे जैसे मान देखिए। सुनिश्चित कीजिए कि वे वहाँ स्ट्रिंग हैं जहाँ आपका आशय स्ट्रिंग था और वहाँ संख्याएँ जहाँ संख्याएँ।
परिवहन के लिए छोटा करना
अगर JSON नेटवर्क पर भेजा जाएगा, तो ऐसे उपकरण हैं जो रिक्त स्थान हटाकर उसे हल्का बनाते हैं। डेटा वही रहता है।
अपने YAML को अच्छे रूपांतरण के लिए तैयार करना
सादा रखिए
जब आप YAML को JSON में बदलें, तो सादा YAML सबसे अच्छा बदलता है: मैप, सूचियाँ और सरल मान। कस्टम टैग जैसी सुविधाएँ अनदेखी की जाती हैं, और ऐंकर केवल फ़ाइल को लंबा बनाते हैं।
प्रकारों के बारे में स्पष्ट रहिए
जो कुछ किसी अन्य प्रकार जैसा दिखे उसे उद्धृत कीजिए। स्पष्ट चतुराई से सुरक्षित है, और JSON ठीक वही ढोएगा जो आपने लिखा।
पहले छोटे टुकड़े से परीक्षण कीजिए
अगर आपकी फ़ाइल बड़ी है, तो एक खंड परीक्षण फ़ाइल में लेकर उसे बदलिए। परिणाम पर एक त्वरित नज़र दिखाती है कि संरचना वैसी है जैसी आप अपेक्षा रखते हैं या नहीं।
YAML को JSON में बदलते समय अधिकतम पाना
रूपांतरण को जाँच के रूप में उपयोग कीजिए
पृष्ठ के सबसे अच्छे उपयोगों में से एक दर्पण के रूप में है। जब आप YAML को JSON में बदलते हैं, तो कोष्ठक ठीक दिखाते हैं कि इंडेंटेशन कैसे समझा गया। अगर कोई कुंजी ग़लत स्तर पर है, या कोई सूची वह प्रविष्टि निगल गई जो उसे नहीं निगलनी थी, तो परिणाम में साफ़ दिखता है। कई लोग कॉन्फ़िगरेशन को केवल यह पुष्टि करने के लिए बदलते हैं कि वह वही कहता है जो उनका आशय था।
सामान्य प्रकार आश्चर्यों पर नज़र रखिए
YAML कुछ सादे शब्दों को अन्य प्रकारों के रूप में पढ़ता है। शब्द no को false पढ़ा जा सकता है, 1.10 जैसे संस्करण को संख्या 1.1, और NO जैसे देश कोड को कुछ पाठकों में बूलियन। कन्वर्टर मानक प्रकारों का पालन करता है, इसलिए जो मान संख्याओं या बूलियन जैसे दिखते हैं उन्हें वैसे ही टाइप किया जाएगा। अगर आप चाहते हैं कि वे पाठ रहें, तो बदलने से पहले YAML में उनके चारों ओर उद्धरण लगाइए।
लंबी स्ट्रिंग और ब्लॉक शैलियाँ
YAML लंबे पाठ के लिए ब्लॉक शैलियाँ देता है, एक जो पंक्ति विराम रखती है और एक जो उन्हें स्पेस में समेट देती है। दोनों वैसे पढ़ी जाती हैं जैसा प्रारूप के रचनाकारों का आशय था, और परिणामी स्ट्रिंग JSON में पंक्ति विरामों के साथ एस्केप अनुक्रमों के रूप में लिखी जाती है। पाठ वही है, और JSON मनुष्य के लिए बस कम सुखद पढ़ने वाला है, जो YAML के अस्तित्व का कारण है।
एक फ़ाइल में कई दस्तावेज़
YAML एक फ़ाइल में एक से अधिक दस्तावेज़ की अनुमति देता है, तीन डैश से अलग किए हुए। अगर आपकी फ़ाइल में कई हैं, तो सोचिए कि कौन-सा चाहिए। उन्हें अलग फ़ाइलों में बाँटिए और हर एक बदलिए, ताकि हर JSON फ़ाइल में एक दस्तावेज़ हो।
कॉन्फ़िगरेशन में रहस्य
कॉन्फ़िगरेशन फ़ाइलों में कभी पासवर्ड, टोकन और कुंजियाँ होती हैं। क्योंकि रूपांतरण आपके ब्राउज़र में होता है, कहीं कुछ नहीं भेजा जाता। फिर भी, बदली हुई फ़ाइल को साझा फ़ोल्डर या ईमेल में मत छोड़िए, और आगे देने से पहले रहस्य हटा दीजिए।
दोनों प्रारूपों को तालमेल में रखना
अगर किसी प्रोजेक्ट को उसी डेटा का YAML और JSON दोनों संस्करण चाहिए, तो एक को स्रोत मानिए और हर बार जब वह बदले तो दूसरा फिर बनाइए। जब भी आप YAML को JSON में बदलें, वर्तमान YAML से कीजिए, और JSON को हाथ से पैच मत कीजिए। इस तरह दोनों अलग नहीं भटक सकते।
स्कीमा के विरुद्ध वैधीकरण
कई उपकरण JSON को स्कीमा के विरुद्ध जाँचते हैं, इसके विवरण के विरुद्ध कि कौन-सी कुंजियाँ और प्रकार अनुमत हैं। YAML कॉन्फ़िगरेशन सीधे हमेशा जाँचा नहीं जा सकता, पर उसका JSON रूप जाँचा जा सकता है। YAML को JSON में बदलने का यह आम कारण है: फ़ाइल को उस प्रणाली तक पहुँचने से पहले वैध कराना जो उसे अस्वीकार कर देती।
गोपनीयता और संचालन
कॉन्फ़िगरेशन के लिए स्थानीय रूपांतरण क्यों मायने रखता है
कॉन्फ़िगरेशन फ़ाइलें अक्सर पते, आंतरिक प्रणालियों के नाम और कभी कुंजियाँ व पासवर्ड रखती हैं। कई ऑनलाइन कन्वर्टर आपकी फ़ाइल सर्वर पर अपलोड करते हैं, प्रोसेस करते हैं और परिणाम लौटाते हैं, और कुछ समय के लिए एक प्रति ऐसी मशीन पर रहती है जिसे आप नियंत्रित नहीं करते। यहाँ आपका अपना ब्राउज़र काम करता है, इसलिए फ़ाइल आपके उपकरण पर रहती है।
आपके जाने पर क्या होता है
जब आप पृष्ठ बंद करते हैं, तो बदली हुई फ़ाइल ब्राउज़र से ग़ायब हो जाती है, इसलिए पहले उसे डाउनलोड कीजिए। आपकी फ़ाइल के बारे में कुछ नहीं रखा जाता।
अगर कुछ ग़लत हो जाए
पृष्ठ YAML त्रुटि रिपोर्ट करता है
उस पंक्ति को देखिए जिसकी ओर वह इशारा करता है। आम कारण हैं इंडेंटेशन के लिए टैब, कोलन के बाद स्पेस का अभाव, या उद्धरण जो बंद नहीं होता।
संरचना वैसी नहीं जैसी मैंने अपेक्षा की
इंडेंटेशन जाँचिए। एक स्पेस खिसकी पंक्ति आपके आशय से भिन्न ब्लॉक की है।
बड़ी फ़ाइल के साथ पृष्ठ अटक जाता है
सब कुछ आपके उपकरण पर चलता है, और बड़ी फ़ाइल को मेमोरी चाहिए। कंप्यूटर पर फिर कोशिश कीजिए, या डेटा बाँट दीजिए।
संबंधित उपकरण
उपकरणों का वही परिवार पड़ोसी कार्यों को ढकता है। वापस जाने के लिए JSON से YAML उपयोग कीजिए। मार्कअप के लिए XML से JSON और JSON से XML उन दोनों के बीच बदलते हैं। तालिकाओं के लिए JSON से CSV, CSV से JSON, JSON से XLSX और XLSX से JSON हैं।
एक हल किया उदाहरण
मान लीजिए आपकी टीम किसी ऐप की सेटिंग टिप्पणियों वाली YAML फ़ाइल में रखती है, दोहराए ब्लॉकों के लिए ऐंकर और रिलीज़ तारीख़ के साथ, और निगरानी उपकरण वही सेटिंग JSON के रूप में चाहता है। आप फ़ाइल को यहाँ छोड़ते हैं और बटन दबाते हैं। एक पल बाद आप ऐसा JSON डाउनलोड करते हैं जिसमें ऐंकर फैलाए गए हैं, तारीख़ स्ट्रिंग है और टिप्पणियाँ चली गई हैं। आप उसे उपकरण को भेजते हैं। YAML अपनी टिप्पणियों के साथ आपके रिपॉज़िटरी में रहता है, उस फ़ाइल के रूप में जिसे लोग संपादित करते हैं।
एक संक्षिप्त जाँच सूची
रूपांतरण से पहले
इंडेंटेशन जाँचिए। जो मान पाठ रहने चाहिए उन्हें उद्धृत कीजिए। YAML रखिए।
रूपांतरण करते समय
फ़ाइल तैयार होने तक पृष्ठ पर रहिए।
रूपांतरण के बाद
JSON खोलिए, संरचना और प्रकार जाँचिए, और उसे उस उपकरण से परखिए जो उसे पढ़ेगा।
आम ग़लतियाँ
टिप्पणियों के बचने की अपेक्षा
वे नहीं बचतीं। स्पष्टीकरणों के लिए YAML रखिए।
अस्पष्ट मानों को सादा छोड़ना
yes, no और 1.0 जैसे मान अन्य प्रकार के रूप में पढ़े जा सकते हैं। उन्हें उद्धृत कीजिए।
टैब उपयोग करना
YAML इंडेंटेशन के लिए टैब की अनुमति नहीं देता। स्पेस उपयोग कीजिए।
आपकी फ़ाइल आपके उपकरण पर रहती है
रूपांतरण स्थानीय रूप से होता है। आपकी फ़ाइल आपका अपना ब्राउज़र पढ़ता है, वहीं दोबारा लिखता है और JSON के रूप में वापस सौंप देता है। कुछ अपलोड नहीं होता, इसलिए सर्वर पर कोई प्रति नहीं रहती और कोई और उसे पढ़ नहीं सकता। निजी सामग्री वाले कॉन्फ़िगरेशन के लिए YAML को JSON में बदलने का यह सुरक्षित तरीक़ा है।
सार
यहाँ YAML को JSON में बदलने के लिए फ़ाइल छोड़िए और बटन दबाइए। वह आपके ब्राउज़र में पढ़ी और लिखी जाती है, इसलिए फ़ाइल आपके उपकरण से कभी बाहर नहीं जाती। सब कुछ रखा जाता है, क्योंकि दोनों वही आकार रखते हैं: मैप, सूचियाँ, स्ट्रिंग, संख्याएँ, बूलियन और null बिना हानि के पार जाते हैं। ऐंकर और उपनाम फैलाए जाते हैं, इसलिए परिणाम अपने पैरों पर खड़ा है। टिप्पणियाँ, ख़ाली पंक्तियाँ और उद्धृत व सादे के बीच का चुनाव YAML फ़ाइल के पढ़ने का ढंग हैं, उसका अर्थ नहीं, और इनमें से कोई नहीं बचता, क्योंकि JSON के पास उन्हें रखने की जगह नहीं। बिना उद्धरण के लिखी तारीख़ पाठ के रूप में पहुँचती है, क्योंकि JSON में तारीख़ नहीं। कस्टम टैगों का सम्मान नहीं होता: केवल मानक प्रकार पढ़े जाते हैं।