Преобразовать YAML в JSON YAML Ain't Markup Language ↔ JavaScript Object Notation Бесплатно Онлайн Безопасно

Зачем люди конвертируют 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

API, принимающему тело в JSON, можно после конвертации передать содержимое файла 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 нет даты. Пользовательские теги не учитываются: читаются только стандартные типы.