Конвертер JSON у YAML
Перепишіть JSON у YAML, який зручно читати, перевіряти й коментувати. Завантажте файли .json і отримайте .yaml з відступами, тими самими ключами, значеннями та порядком, готовий до додавання в репозиторій.
Конвертер даних
або перетягніть Файли CSV, TSV, TXT … сюди ·
До 95 МБ на файл· До 20 файлів· Видаляються через 30 хв
Файли обробляються на наших серверах і видаляються через 30 хв.
Символ, що розділяє стовпці у файлах CSV і тексту, і під час читання, і під час запису. «Авто» визначає його з вхідних даних і записує коми.
UTF-8 підходить для всіх мов. Виберіть UTF-8 with BOM, якщо Excel у Windows показує спотворені літери або азійські символи під час відкриття CSV.
Для файлів Excel, ODS і Numbers: перетворити лише перший аркуш або всі (по одному CSV на аркуш у ZIP чи по одному ключу JSON на аркуш).
Назва вкладки аркуша в новій таблиці, до 31 символу.
Масив об’єктів використовує назви стовпців як ключі для кожного рядка; масив масивів компактніший і зберігає заголовок як перший масив.
Назва зовнішнього елемента, що обгортає всі рядки; кожен рядок стає елементом <row> усередині нього.
Використовується в операторах CREATE TABLE та INSERT. Лише літери, цифри та підкреслення.
Лапки та типи стовпців трохи відрізняються в різних базах даних; виберіть ту, у яку імпортуватимете.
Переписати клітинки з датами в одному форматі. ISO (2026-10-18) — найнадійніший для баз даних і коду; «Без змін» залишає їх такими, як у джерелі.
Як користуватися цим інструментом
- 1
Додайте файли JSON
Завантажте відповіді API, експортовані налаштування або згенеровані маніфести у форматі .json: до 20 файлів, кожен до 95 MB. Кожен файл має містити одне коректне значення JSON.
- 2
Залиште типові налаштування
YAML уже вибрано в полі Конвертувати в. Для конфігураційного файлу більше нічого змінювати не потрібно; у результаті використовується відступ у два пробіли.
- 3
Конвертуйте й закомітьте
Натисніть Конвертувати в YAML, завантажте файли .yaml, додайте коментарі там, де вони знадобляться наступному читачеві, і закомітьте зміни.
Як конвертувати JSON у YAML?
Завантажте файл .json і натисніть Конвертувати в YAML. Об’єкти стають блоками key: value з відступами, масиви — списками з дефісами, а рядки, які YAML може прочитати неправильно, зберігають лапки.
Навіщо конвертувати JSON у YAML для конфігураційних файлів
Більшість JSON створює програмне забезпечення: відповідь API, експорт налаштувань, результат генератора. Більшість YAML підтримують люди. Конвертація зазвичай позначає момент, коли дані перестають бути машинним виводом і стають тим, чим володіє команда: маніфестом розгортання в Git, конвеєром CI або набором змінних Ansible.
Типовий випадок: ви викликаєте API хмарного сервісу, отримуєте JSON-опис ресурсу на 200 рядків і хочете зберегти його як інфраструктуру у вигляді коду. Після конвертації файл без дужок і ком, де зміна одного рядка дає diff в один рядок, а дивні значення можна пояснити в коментарях. Те саме стосується тестових фікстур і файлів перекладів, які редагують не розробники. Якщо ж потрібна пласка таблиця, для електронної таблиці чи звіту, краще підійде JSON у CSV.
Інструменти з конфігураційними файлами у YAML
| Організація | Вимога | Джерело |
|---|---|---|
| GitHub Actions | Робочі процеси лежать у .github/workflows як файли .yml або .yaml | GitHub Docs |
| GitLab CI/CD | Конвеєр описано у файлі .gitlab-ci.yml у корені репозиторію | GitLab Docs |
| Docker Compose | Сервіси описано у compose.yaml (раніше docker-compose.yml) | Docker Docs |
| Ansible | Плейбуки та файли змінних пишуть у YAML | Ansible Docs |
| Kubernetes | Маніфести приймають JSON або YAML; документація та чарти Helm використовують YAML | Kubernetes |
Приклад конвертації JSON у YAML зі складними значеннями
# "NO" у лапках: без них YAML 1.1 прочитає країну як false name: api version: "1.10" debug: false tags: - web - eu country: "NO"
Що дає YAML
- Коментарі з #
- Коротші diff у код-рев’ю
- Без дужок, ком і лапок у більшості рядків
- Багаторядковий текст через блокові скаляри |
На що звернути увагу
- Відступ несе зміст, тож зайвий пробіл змінює структуру
- Табуляція для відступів не допускається
- Рядки без лапок можуть бути прочитані як числа чи булеві значення
- Парсери повільніші й менш одноманітні, ніж для JSON
Приклад показує, чому простої заміни дужок недостатньо. Версія 1.10 у JSON — рядок; записана в YAML без лапок, вона буде прочитана як число 1.1. NO, код ISO для Норвегії, парсери YAML 1.1, як-от PyYAML, прочитають як false. Обидва значення зберігають лапки, а справжні числа й булеві значення лишаються без них.
Порівняння JSON і YAML
JSON
JavaScript Object Notation
JSON — легкий текстовий формат для структурованих даних, який на початку 2000-х популяризував Дуглас Крокфорд і який стандартизовано як RFC 8259 та ECMA-404. Він передає об’єкти, масиви, рядки, числа, булеві значення та null простим читабельним синтаксисом. Це формат за замовчуванням для вебAPI, конфігураційних файлів і обміну даними між застосунками майже в усіх мовах програмування. У ньому немає вбудованих коментарів, дат і схем, а великі вкладені файли важко читати без переглядача.
- Стиснення
- –
- Прозорість
- –
- Анімація
- –
- Рік появи
- 2001 · Douglas Crockford
YAML
YAML
YAML («YAML Ain't Markup Language») — зручний для людини формат даних, уперше випущений у 2001 році. Він використовує відступи замість дужок, підтримує коментарі та є надмножиною JSON. Його широко застосовують для конфігурації в Docker Compose, Kubernetes, GitHub Actions і багатьох програмах. Через залежність від пробілів його легко зламати одним зайвим пробілом, а деякі значення, наприклад «no» або дати, можуть інтерпретуватися несподівано.
- Стиснення
- –
- Прозорість
- –
- Анімація
- –
- Рік появи
- 2001 · Clark Evans, Ingy döt Net, Oren Ben-Kiki
JSON конвертують у YAML, коли згенеровані дані або дані з API мають стати конфігураційним файлом, який підтримують люди, перевіряють у pull request і супроводжують коментарями.
Запитання про конвертер JSON у YAML
Чи є JSON уже коректним YAML?
У YAML 1.2 так: редакцію 2009 року написано так, що кожен документ JSON є також документом YAML. Можна вставити JSON у файл .yaml, і більшість інструментів його прийме. Конвертація потрібна для читабельності: блоковий стиль без дужок, лапок і ком — це те, чого очікують рецензенти та наступний мейнтейнер.
Чому деякі значення в YAML взято в лапки?
Бо без лапок YAML прочитає їх як інший тип. Рядок версії на кшталт 1.10 стане числом 1.1, а yes чи off у старіших парсерах можуть стати булевими значеннями. Рядки, схожі на числа, дати чи булеві значення, потребують лапок, щоб лишитися рядками, тому коректна конвертація їх зберігає.
Чи можна додати коментарі після конвертації?
Так, і це поширена причина конвертувати. Напишіть # і примітку в кінці рядка або в окремому рядку. У JSON не було способу пояснити, чому значення саме таке; у YAML він є, що полегшує рев’ю та передачу проєкту.
Чому YAML видає помилку через символ табуляції?
Специфікація YAML забороняє табуляцію для відступів; враховуються лише пробіли. Конвертер записує пробіли, але редактор, налаштований вставляти табуляцію, може зіпсувати файл під час наступного редагування. Налаштуйте редактор на пробіли для файлів .yaml.
Чи прийме Kubernetes сконвертований маніфест?
kubectl читає і JSON, і YAML, тож дані однакові в обох випадках; просто версію YAML використовують більшість документації, чартів Helm і код-рев’ю. Якщо згодом знадобиться JSON для jq або виклику API, YAML у JSON зробить зворотне перетворення.
- Конвертер YAML у JSONКонвертуйте .yaml і .yml у JSON для API, валідаторів і програм, що читають лише JSON. Відступи за замовчуванням, до 20 файлів, видалення за 30 хв.
- Конвертер JSON у XMLКонвертуйте JSON у XML онлайн: ключі стають елементами, масиви — повторюваними елементами в кореневому тегу з вашою назвою. Без реєстрації.
- Конвертувати JSON у CSVJSON або JSON Lines у CSV: рядок на кожен об’єкт, вкладені поля стають стовпцями, UTF-8 з BOM для коректних літер в Excel. До 20 файлів одночасно.
- Конвертер XML у JSONПеретворіть XML на зручний JSON: атрибути стають ключами з @, повторювані теги — масивами, текст зберігається. Для SOAP, фідів і старих експортів.
- Кодування JSON у Base64Закодуйте JSON-файл в один рядок Base64 для Kubernetes Secrets, змінних CI, запитів API і токенів. Повністю зворотно, data URI за бажанням.
- Конвертер JSON в ExcelКонвертуйте JSON або JSON Lines в аркуш Excel XLSX: ключі стають заголовками стовпців, записи — рядками. До 20 файлів за раз, без реєстрації.