Инструменты YAML

Форматировщик YAMLРазберите структуру конфигурации

По умолчанию: два пробела и все документы. Позиции в структуре и якорях относятся к исходному тексту; копируется всегда YAML.

Форматировщик YAML

Исходный YAML

Результат

Данные обрабатываются в этой вкладке и не отправляются на сервер.

Параметры

Результат устарел. Запустите форматирование.

Форматировщик YAML помогает читать вложенные настройки вместе с комментариями, которые объясняют их назначение. Якоря и псевдонимы остаются ссылками, а числа сохраняют исходную запись. Результат появляется рядом с исходным текстом, не заменяя его.

Форматирование YAML поддерживает отступ в два или четыре пробела. Встроенный валидатор YAML сначала разбирает весь поток и только затем позволяет выбрать один документ для экспорта. Так можно проверить YAML онлайн и не пропустить ошибку в другой части входных данных.

Чем полезен Форматировщик YAML

Комментарии остаются рядом с настройками

Примечание о выбранном значении часто важнее самого числа. Комментарии, числовые токены и ссылки сохраняются в результате. При этом пробелы и представление строк могут измениться: удобное форматирование не означает побайтовое совпадение с оригиналом.

Два представления документа с разными отступами и сохранёнными отметками комментариев, чисел и ссылок.

Выбор документа после общей проверки

Поток может содержать несколько документов, разделённых ---. Ошибка во втором документе блокирует результат даже при выборе первого. После исправления можно экспортировать нужную часть, сохранив весь исходный поток в поле ввода.

Два отдельных документа со своими ссылками; один выделен для переноса в результат.

На что обратить внимание перед экспортом

01

Выберите режим запуска

Автоматический режим включён и ждёт 350 мс после изменения. Отключите его, чтобы увидеть кнопку запуска; также работает Ctrl/Cmd+Enter. Изменение текста, отступа или документа делает результат устаревшим: копирование и скачивание ждут актуальной проверки. Пример и Очистить сначала показывают предпросмотр с количеством строк. Применение заменяет источник; отмена один раз восстанавливает вход, выход и параметры.

02

Ищите строки в исходном тексте

Вкладки структуры и якорей показывают позиции исходных данных, а не заново отформатированного результата. Списки открывают по 50 записей с возможностью показать ещё. По этим позициям удобно найти определение якоря или место использования ссылки.

03

Различайте выбор и отображение

Список документов определяет содержимое экспорта. Вкладки YAML, структуры и якорей меняют лишь представление. Копирование из вкладки якорей всё равно возвращает выбранный YAML, а не список определений и ссылок.

Проверка значений и связей

Без округления при записи чисел

Большие целые числа, десятичные записи, показатели степени и допустимые особые значения вроде .inf сохраняют исходные числовые токены. Вывод не строится из округлённых чисел JavaScript, поэтому длинные идентификаторы не теряют разряды.

Ссылки без разворачивания

Для якорей и псевдонимов видны документ и строка. Допустимые ссылки остаются ссылками. Разрешённые циклы не разворачиваются в бесконечно растущее дерево, а просмотр структуры не создаёт копии связанных значений.

Контроль повторяющихся ключей

Форматировщик YAML отклоняет семантически равные скалярные ключи внутри одного отображения. Другая запись того же числа не обходит проверку. Более позднее значение не перезаписывает предыдущее без сообщения об ошибке.

Экспорт отдельной части потока

После успешной проверки всех документов можно выбрать один или оставить весь поток. Исходные данные не обрезаются, поэтому для экспорта другой части достаточно сменить выбор. Отдельный документ не скрывает ошибки остальных.

Поддерживаемый синтаксис и ограничения

Только YAML 1.2 Core
Другие директивы версии и неподдерживаемые теги отклоняются. Ключами могут быть строки, числа, логические значения и null, но не коллекции и не псевдонимы. << считается обычным ключом: слияние по правилам YAML 1.1 не выполняется.
Ошибки не исправляются догадками
Некорректный синтаксис или повтор ключа в любом документе останавливает весь вывод. Инструмент не угадывает правильную вложенность и не заменяет табуляцию для исправления отступов. Исправьте источник; выбор другой части не позволит обойти проверку.
Якоря действуют внутри документа
Псевдоним должен ссылаться на ранее определённый якорь в своём документе. Неопределённые и междокументные ссылки отклоняются, допустимые не разворачиваются. Проверка синтаксиса не проверяет поля и схемы Kubernetes, Docker Compose или систем CI.
Ограниченный объём обработки
Пределы: 500 000 единиц UTF-16 на входе, 100 документов, глубина 100, 50 000 узлов и 2 000 000 единиц на выходе. При превышении обработка прекращается без частичного экспорта. Сортировки, минификации, преобразования в JSON, импорта файлов и загрузки по URL нет.

Вопросы про Форматировщик YAML

Как найти синтаксическую ошибку в YAML?

Сообщение указывает строку и столбец исходного текста. Проверьте отступы, разделители и соседние ключи; причина может находиться выше указанной позиции. Ошибка остаётся на странице, пока вы исправляете данные. Обрабатывается весь поток, поэтому проблема может быть в другом документе.

Можно ли обработать большой файл?

Допускается до 500 000 единиц UTF-16 во входном тексте. Дополнительно действуют пределы: 100 документов, глубина 100 и 50 000 узлов; вывод ограничен 2 000 000 единиц. Это не лимит размера файла в байтах. При превышении результат не обрезается для скачивания.

Передаются ли мои настройки на сервер?

Нет. Обработка выполняется в открытой вкладке. Поля для отправки файла или загрузки удалённой конфигурации здесь нет. Копирование и скачивание результата происходят только по вашему действию.

Нужна ли регистрация для работы?

Нет. Форматировщик YAML доступен без регистрации. Можно загрузить пример, выбрать отступ, посмотреть определения якорей и экспортировать результат без создания учётной записи.

Есть ли плата за форматирование?

Нет, форматирование и доступные проверки бесплатны. Выбор одного документа, просмотр структуры и экспорт не требуют оплаты. Для проверки правил конкретного приложения используйте дополнительно средства этого приложения.

Результат вызывает вопросы?

Перейдите к своей конфигурации

Откройте пример: Форматировщик YAML покажет ссылки и позволит сравнить экспорт всего потока с отдельным документом.