Безплатен конвертор

JSON към YAML конвертор

Преобразувайте JSON структура в чист YAML формат. Идеален за манифести на Kubernetes и облачни конфигурации.

или

За този инструмент

Преминаването от JSON към YAML е свързано най-вече с това да направим данните по-четими за хората. И двата формата описват едни и същи видове структури — обекти/карти, масиви/последователности, скалари — но базираният на отстъп синтаксис на YAML, опционалното цитиране и поддръжката за коментари улесняват сканирането и редактирането на ръка. Конфигурационните файлове са каноничният случай на употреба: манифестите на Kubernetes, работните потоци на CI, книгите за игри на Ansible и десетки други инструменти избраха YAML специално, защото основните им редактори са хора.

Този конвертор използва js-yaml за сериализиране на анализиран JSON обект в YAML. Резултатът запазва точно структурата на данните, докато прилага YAML конвенциите: отстъп за влагане, списъци за масиви, двойки ключ-стойност за свойства на обекта. Стриктното двойно цитиране на JSON е облекчено; само низове, съдържащи специални символи или които изглеждат като други типове, са цитирани в изхода.

Преобразуването запазва информацията, освен когато YAML добавя изразителност, която JSON не е имал. Коментарите не могат да бъдат реконструирани (JSON нямаше такива). Препратките към котва и псевдоним потенциално биха могли да компресират повтарящи се структури, но не се генерират автоматично; изходът разширява всички препратки в ред.

Защо да конвертирате JSON в YAML

YAML е драматично по-четим от JSON за хора, които редактират конфигурацията. Отстъпът замества влагането на скоби, кавичките не са задължителни за прости низове, а коментарите могат да документират неочевидни настройки. За файлове, които хората поддържат – конфигурация на приложението, инфраструктура като код, изграждане на тръбопроводи – YAML почти винаги е правилният дестинационен формат.

Модерните инфраструктурни инструменти в голяма степен предпочитат YAML. Kubernetes, Helm charts, Ansible, GitHub Actions, GitLab CI, Docker Compose и много други инструменти или предпочитат, или изискват YAML. Преобразуването на JSON експорти от една система в YAML конфигурация за друга е рутинна стъпка на интеграция.

Как да използвате

Поставете JSON, вземете YAML.

  1. Добавете своя JSON: Поставете JSON текст или пуснете файл. Въведеното трябва да е валиден JSON; конверторът не се опитва да анализира JSON-подобен вход, който нарушава спецификацията.
  2. Изберете опции: Размерът на отстъпа по подразбиране е 2 интервала, най-често срещаната YAML конвенция. Стилът на потока (подобен на компактен JSON) спрямо блоковия стил (базиран на отстъпи) превключва външния вид на изхода — блокът е удобната за хората настройка по подразбиране.
  3. Преобразуване: Dump функцията на js-yaml сериализира анализираното JSON дърво в YAML. Цитирането на низове се прилага само когато е необходимо; сложните низове остават четими.
  4. Изтеглете или копирайте: Запазете като .yml или копирайте в клипборда. Резултатът е валиден YAML 1.2, готов за всеки потребител на YAML.

Обичайни случаи на употреба

Технически подробности

Функцията dump на js-yaml обикаля дървото на обектите на JavaScript и излъчва YAML, използвайки конфигурируемо форматиране. Дълбочината на отстъпа, ширината на линията, прагът на стила на потока и обработката на котировките са параметри. Настройките по подразбиране създават YAML в блоков стил с отстъп от 2 интервала, най-често срещаната конвенция.

Цитирането на низове следва правилата на YAML: низове, които изглеждат като други типове (числа, булеви стойности, null, дати), се цитират, за да се принуди интерпретацията на низове; низове, съдържащи специални знаци (двоеточие, решетки, водещи тирета) се поставят в кавички; простите азбучни низове остават без кавички.

Изходът е съвместим с YAML 1.2 и анализира чисто с js-yaml, PyYAML и други основни библиотеки на YAML. Идемпотентните обиколки (JSON → YAML → JSON) запазват данните, въпреки че YAML представянето избира канонично форматиране, което може да се различава от ръкописен еквивалент.

Най-добри практики

Често задавани въпроси

Преобразуването на JSON в YAML променя ли съдържанието?
Съдържанието е запазено възможно най-точно. Някои специфични за формата функции обаче може да нямат директни еквиваленти, така че могат да възникнат малки разлики във форматирането.
Защо да използвате YAML формат?
YAML е популярен за конфигурационни файлове, защото е много четим с минимален синтаксис. Това е стандартът за Docker Compose, Kubernetes, GitHub Actions и много CI/CD инструменти.
Конверторът обработва ли вложени или сложни JSON структури?
да Инструментът анализира правилно вложени обекти, масиви и всички стандартни типове данни JSON, като запазва пълната структура на данните в YAML изхода.
Сигурно и поверително ли е това преобразуване?
да Цялата обработка се извършва локално във вашия браузър. Вашите данни никога не напускат вашето устройство — без качване на сървър, без обработка в облак, без събиране на данни.
Какво ще кажете за низове със специални знаци?
js-yaml ги цитира автоматично. Низовете, съдържащи двоеточия, хешове или водещи тирета, са обвити в кавички, за да се запази YAML добре оформен.
Данните ми качват ли се на сървър?
Не. Преобразуването се изпълнява във вашия браузър с помощта на js-yaml.
Мога ли да прехвърля JSON към YAML и обратно?
да JSON → YAML → JSON запазва данните структурно. Редът на ключовете на конвертирания JSON съответства на входа.
Какъв е максималният входен размер?
До 50 MB. js-yaml обработва незабавно типичните конфигурационни файлове.