تبدیل YAML به JSON YAML Ain't Markup Language ↔ JavaScript Object Notation رایگان آنلاین امن
فایل YAML خود را رها کنید و JSON تحویل بگیرید. خواندن و نوشتن فایل همین‌جا، در مرورگر شما انجام می‌شود، پس فایل هرگز از دستگاهتان خارج نمی‌شود — و اینکه این تبدیل چه چیزی را حفظ می‌کند و چه چیزی را نمی‌تواند، در ادامه نوشته شده است تا مجبور نباشید خودتان کشفش کنید.
فایل خود را تبدیل کنید
فایل YAML خود را اینجا رها کنید یا یکی را انتخاب کنید.
فایل شما هرگز از این دستگاه بیرون نمی‌رود. همه‌چیز در مرورگر شما اجرا می‌شود.
بدون بارگذاری
تبدیل از YAML
تبدیل به YAML
این قالب‌ها از کجا آمده‌اند
CSV قدیمی‌ترین و کم‌استانداردترین آن‌هاست: جدولی که به شکل خطوط متن نوشته می‌شود، از دههٔ 1970 در کار بوده و تنها در سال 2005 به‌صورت مکتوب توصیف شد، یعنی زمانی که هر برنامه‌ای از قبل خودش تصمیم گرفته بود جداکننده چیست و چه زمانی باید گیومه گذاشت. XML در سال 1998 از SGML برآمد، برای اسنادی که باید ساختاری سخت‌گیرانه داشته باشند و در برابر یک طرح‌واره (schema) بررسی شوند. JSON را داگلاس کراکفورد حدود سال 2001 از دل جاوااسکریپت بیرون کشید و عمداً به اشیاء، آرایه‌ها، اعداد و رشته‌ها تقلیلش داد — و همین حداقل‌گرایی دلیل آن است که وب را در دست گرفت. YAML پسرعموی خواناتر آن است که در آن تورفتگی کاری را می‌کند که در جاهای دیگر کروشه و آکولاد می‌کنند. تنها نکته‌ای که هنگام تبدیل میان آنها اهمیت دارد: CSV تخت است، شبکه‌ای از سطر و ستون، درحالی‌که JSON، XML و YAML درخت هستند.
کجا با آنها روبه‌رو می‌شوید
CSV همان چیزی است که صفحه‌گسترده خروجی می‌دهد و حسابدار، پلتفرم فروشگاهی یا صورت‌حساب بانکی به شما تحویل می‌دهد. JSON زبانی است که سرویس‌های وب با آن حرف می‌زنند و فایل‌های پیکربندی روزبه‌روز بیشتر به آن نوشته می‌شوند. XML در سیستم‌های سازمانی قدیمی‌تر، در استانداردهای صدور فاکتور و درون خود قالب‌های اداری باقی مانده است. YAML جایی است که انسان‌ها تنظیمات را با دست می‌نویسند. تبدیل میان آنها کار روزمرهٔ انتقال داده از جایی است که تولید شده به جایی که لازم است.
پرسش‌های متداول
فایل CSV من در Excel به‌صورت یک ستون باز شد. چرا؟
چون صفحه‌گستردهٔ شما جداکنندهٔ دیگری انتظار داشت. Excel از جداکنندهٔ فهرست در تنظیمات منطقه‌ای رایانه پیروی می‌کند، که در هر جایی که ویرگول پیش‌تر علامت اعشار است — یعنی بیشتر اروپای قاره‌ای — نقطه‌ویرگول است. فایلی که با ویرگول جدا شده باشد آن‌گاه مانند یک ستون واحد از متن دیده می‌شود. به‌جای دوبار کلیک کردن روی فایل، از پنجرهٔ درون‌ریزی (import) استفاده کنید و جداکننده را صریحاً مشخص کنید. همین تنظیم منطقه‌ای دلیل آن است که گاهی 3.5 به‌صورت یک تاریخ وارد می‌شود.
چرا JSON تودرتوی من نمی‌تواند به یک صفحه‌گستردهٔ مرتب تبدیل شود؟
چون صفحه‌گسترده تخت است و JSON درخت. یک سطر در هر ستون فقط یک مقدار می‌تواند داشته باشد؛ اما یک شیء JSON می‌تواند فهرستی درون یک فیلد درون فهرستی دیگر داشته باشد. تبدیل یعنی انتخاب شیوهٔ تخت کردن آن: یا به هم چسباندن نام‌های تودرتو در یک عنوان ستون بلند، یا تکرار سطر والد به‌ازای هر فرزند. هر دو سازش هستند و هیچ‌کدام به‌طور خودکار قابل بازگشت نیست — به همین دلیل بازگشت از صفحه‌گسترده به شکل اصلی معمولاً به تصمیم یک انسان نیاز دارد.
آیا فایل کیفیتش را از دست می‌دهد؟
بستگی دارد که دو قالب چه چیزی را می‌توانند نگه دارند. تبدیل میان قالب‌هایی که همان چیز را ذخیره می‌کنند — مثلاً PNG به BMP یا WAV به FLAC — هیچ چیزی را از دست نمی‌دهد. تبدیل به قالبی که برای صرفه‌جویی در فضا اطلاعات را دور می‌ریزد، مانند JPEG یا MP3، هر بار کمی کیفیت از دست می‌دهد و تبدیل دوباره آن را برنمی‌گرداند. هر جا انتخابی وجود داشته باشد، این صفحه به‌جای ساخت کوچک‌ترین فایل، به حفظ کیفیت اصلی گرایش دارد.
آیا فایل من جایی بارگذاری می‌شود؟
نه. تبدیل درون مرورگر شما و روی دستگاه خودتان انجام می‌شود؛ فایل هرگز از آن خارج نمی‌شود و اینجا سروری نیست که بتواند آن را دریافت کند. به همین دلیل است که محدودیت یک فایل بزرگ حافظه خودِ شماست، نه بارگذاری، و به همین دلیل است که هیچ چیزی که تبدیل می‌کنید نمی‌تواند در لاگ‌های کسی ظاهر شود — از جمله لاگ‌های ما. ابزارهای صوت و ویدیو، اولین باری که از آنها استفاده می‌کنید، موتور تبدیل خود را از همین سایت دریافت می‌کنند، حدود سی مگابایت و فقط یک بار؛ پس از آن کار باز هم کاملاً روی دستگاه شما انجام می‌شود.
چرا مردم YAML را به JSON تبدیل می‌کنند
YAML نشانه‌گذاری‌ای است که مردم وقتی باید داده را با دست بنویسند برمی‌گزینند. به‌جای آکولاد از تورفتگی استفاده می‌کند، توضیح را مجاز می‌داند و تقریباً مثل یک رئوس مطالب خوانده می‌شود، به همین دلیل محبوب پیکربندی شد: خط لوله‌های ساخت، تعریف کانتینرها، فایل‌های استقرار، تنظیمات سایت ایستا، ابزارهای مستندسازی و شمار بی‌پایانی از پیکربندی‌های برنامه. JSON نشانه‌گذاری‌ای است که برنامه‌ها ترجیح می‌دهند دریافت کنند. سخت‌گیر است، توضیح ندارد و هر زبان برنامه‌نویسی با کتابخانهٔ استاندارد آن را می‌خواند. وقتی فایلی که برای انسان‌ها نوشته شده باید به برنامه، API یا ابزاری که فقط JSON می‌پذیرد سپرده شود، تبدیل لازم است. به همین دلیل مردم YAML را به JSON تبدیل می‌کنند: داده را به شکلی دارند که نوشتنش خوشایند است و مقصد شکلی را می‌خواهد که تجزیه‌اش آسان است.
موقعیت‌ها روزمره‌اند. توسعه‌دهنده‌ای که پیکربندی‌ای را به YAML نگه می‌دارد و باید آن را به‌صورت JSON برای سرویسی بفرستد. تیمی که می‌خواهد فایل تنظیمات را با ابزاری که JSON بررسی می‌کند اعتبارسنجی کند. نویسنده‌ای که front matter به 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ها
به APIای که بدنهٔ JSON می‌گیرد می‌توان پس از تبدیل محتوای فایل YAML را داد. این به شما امکان می‌دهد فایل را به شکلی که دوست دارید ویرایش کنید نگه دارید.
فایل‌های مستندات و محتوا
مولدهای سایت ایستا و ابزارهای مستندسازی از YAML برای front matter و فایل‌های داده استفاده می‌کنند. تبدیل آنها به ابزارهای دیگر امکان می‌دهد همان داده را بخوانند.
توصیهٔ عملی پیش از تبدیل 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 تاریخ ندارد. برچسب‌های سفارشی رعایت نمی‌شوند: فقط نوع‌های استاندارد خوانده می‌شوند.