Ключові моменти
- 01Форматує YAML з постійним відступом за допомогою парсера js-yaml — тієї ж бібліотеки, яка використовується у инструментах Node.js.
- 02Перевіряє синтаксис й повідомляє точні номери рядків для помилок.
- 03Конвертує між YAML й JSON в обох напрямках з правильним збереженням типу.
- 04Нічого не завантажується — вся операція запускається локально у вашому браузері.
Чому форматування YAML важливе для файлів конфігурації
YAML — мова конфігурації за замовчуванням для Kubernetes, GitHub Actions, Docker Compose, Helm діаграм і багатьох інших інструментів. Вона також чутлива до відступів — один помилковий рядок з відступом може виробити мовчазне невідповідність типу або жорстку помилку розбору, яка блокує розгортання. Регулярне форматування зберігає файли послідовними й ловить проблеми перед дійсною CI.
Конвертація між YAML й JSON однаково корисна. Деякі інструменти приймають тільки JSON для викликів API або визначень схеми, поки люди, як правило, люблять YAML для довголітніх файлів конфігурації. Можливість двостороннього обміну між ними без втрати типів даних — числа залишаються числами, булеви значення залишаються булеві — економить час й запобігає тонким помилкам.
Як форматувати чи конвертувати YAML
- 01
Вставте свій YAML чи JSON
Вставте маніфест Kubernetes, робочий процес GitHub Actions, файл значень Helm або будь-який інший документ YAML. Для конвертації JSON-to-YAML вставте JSON замість цього.
- 02
Виберіть дію
Виберіть Format YAML, щоб нормалізувати відступ й очистити документ на місці. Виберіть YAML to JSON або JSON to YAML, щоб повністю конвертувати формат.
- 03
Переглядайте помилки, якщо вони є
Якщо введення має помилку синтаксису, інструмент виводить точний номер рядка й причину від парсера js-yaml — цей же парсер, що ваш инструмент Node.js використовує, тому помилка збігається з тим, що ви бачитимете у виробництві.
- 04
Копіюйте вивід
Клацніть Копіювати, щоб отримати відформатований чи конвертований вивід. Вставте назад у файл конфігурації, тіло API чи визначення схеми.
Коли цей інструмент заощаджує вам час
- 01Маніфест Kubernetes відійшов — нормалізуйте відступ перед фіксацією.
- 02Робочий процес GitHub Actions не розбирається — перевірте, щоб отримати точний рядок помилки.
- 03API приймає тільки JSON, але конфігурація зберігається як YAML — конвертуйте одним кліком.
- 04Онбординг нової послуги — конвертуйте приклад завантаження JSON на YAML для діаграми Helm.
- 05Копіювання YAML з Stack Overflow — переформатуйте, щоб збігатися з 2-простійним стилем вашого проекту.
- 06Налагодження Helm значень злиття — перевірте, що кожен values.yaml індивідуально чистий.
Приватно, без завантаження
Форматування й конвертація запускаються повністю у вашому браузері за допомогою js-yaml — тієї ж бібліотеки, яка зв'язана у Webpack, Rollup та більшість инструментів JavaScript. Ваші файли конфігурації, посилання на секрети й імена змінних середовища ніколи не залишають ваш пристрій.
Парсер спрямовується на YAML 1.2, що використовує Kubernetes, GitHub Actions, Docker Compose й Helm. Якщо файл перевіряється тут, він завантажиться правильно в цих інструментах.
FAQ YAML форматера
Чи збереже форматування YAML коментарі?
Ні. Парсер js-yaml видаляє коментарі під час розбору — це обмеження всіх JavaScript YAML парсерів. Форматуйте спочатку, потім додавайте коментарі вручну назад.
Яку версію YAML це підтримує?
YAML 1.2, який використовується Kubernetes, GitHub Actions, Docker Compose й Helm. Те, що перевіряється тут, завантажуватиметься чисто в цих інструментах.
Чи конвертація з YAML на JSON зберігає типи?
Так. Числа, булеві значення, null й рядки дат кругловиходять правильно. Аtrue в YAML стає булевим true у JSON, а не рядком 'true'.
Яка різниця між форматуванням й конвертацією?
Форматування зберігає файл як YAML й нормалізує пробіли й відступи. Конвертація змінює вихідний формат повністю — YAML to JSON виробляє документ, сумісний з .json.
Мій YAML має кілька документів, відокремлених ---. Чи всі вони буватимуть оброблені?
Перший документ розбирається й переушифрується. Для мультидокументів файлів розділіть кожну секцію на --- й обробіть їх індивідуально.