Валидатор и форматер YAML

Вставьте YAML, чтобы проверить синтаксис, найти ошибки и получить чистый, единообразно отформатированный вывод.

Параметры вывода

YAMLввод

Пусто

YAMLвывод

Здесь появится вывод YAML

Работает полностью в вашем браузере: ничего не загружается на сервер. Действуют ограничения добросовестного использования (5 MB на ввод, лимит частоты конвертаций) для защиты от спама и ботов.

Загрузка по URL

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

Сочетания клавиш

Ctrl / ⌘ + Enter Конвертировать сейчас
Ctrl / ⌘ + S Скачать вывод
Alt + Shift + C Копировать вывод
Alt + Shift + F Исправить и отформатировать входной JSON
Alt + Shift + S Поменять направление
Alt + Shift + T Переключение между видами: код, дерево и карта
Ctrl / ⌘ + Z Отменить, в том числе «Формат», «Исправить» и «Очистить»
Esc Выйти из полноэкранного режима
Размер текста в редакторе

Приведите неаккуратный YAML к порядку

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

Ввод
services:
    web:
        image: "nginx:1.27"
        ports: [ "80:80" ]
        environment: {LOG_LEVEL: info, DEBUG: 'false'}
Отформатировано
services:
  web:
    image: nginx:1.27
    ports:
      - '80:80'
    environment:
      LOG_LEVEL: info
      DEBUG: 'false'

Типичные ошибки YAML и как их исправить

Это сообщения, которые вы будете видеть чаще всего: в этом валидаторе и в инструментах вроде kubectl, Helm и docker compose.

Сообщение об ошибкеЧто оно значит и как исправить
tab characters must not be used in indentation YAML допускает в отступах только пробелы. Замените каждую табуляцию пробелами.
bad indentation of a mapping entry Ключ имеет другой отступ, чем соседние, или простое значение содержит ": ". Выровняйте ключ по соседям или заключите значение в кавычки.
mapping values are not allowed in this context Та же проблема в формулировке kubectl и Helm: обычно значение без кавычек, содержащее ": ", например URL или время. Заключите значение в кавычки.
end of the stream or a document separator is expected Элемент списка или ключ стоит на неправильном уровне отступа, например список, за которым на том же уровне следует словарь.
unexpected end of the stream within a flow collection Встроенный список [ … ] или словарь { … } не закрыт. Добавьте недостающую скобку.
duplicated mapping key Один и тот же ключ встречается в словаре дважды. Удалите или переименуйте один из них.
unidentified alias Алиас вроде *defaults используется раньше своего якоря &defaults или вообще без него.

Что проверяет валидатор

Намеренно сломайте файл кнопками и посмотрите, какая проверка это поймает.

Синтаксис и отступы

Табуляции, смещённые ключи, незакрытые кавычки и скобки сообщаются с точной строкой и столбцом.

Повторяющиеся ключи

Ключ, определённый дважды в одном словаре, считается ошибкой, тогда как некоторые парсеры молча оставляют последнее значение.

Якоря и алиасы

Каждый алиас должен указывать на якорь, определённый раньше в документе, а ключи слияния должны ссылаться на словари.

Несколько документов

Каждый документ в файле, разделённом ---, разбирается, а в заметках видно, сколько их найдено.

Приватность по умолчанию

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

Другие инструменты

Конвертеры, валидаторы и пошаговые руководства для всех мест, где встречаются JSON и YAML.

Частые вопросы

Как проверить YAML онлайн?

Вставьте YAML или перетащите файл .yaml или .yml. Значок показывает «Корректный YAML» или «Некорректный YAML» прямо при вводе. Для некорректного файла выводится сообщение об ошибке с точной строкой и столбцом, а строка подсвечивается в редакторе.

Что делает отформатированный вывод?

Он заново записывает те же данные с единообразными отступами и кавычками: блочный стиль, выбранный вами отступ и кавычки только там, где они нужны. Это быстрый способ нормализовать файл перед коммитом.

Сохраняются ли комментарии в отформатированном выводе?

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

Можно ли проверить многодокументный файл YAML?

Да. Каждый из документов, разделённых ---, проверяется, а отформатированный вывод сохраняет их как отдельные документы. Заметки под редактором показывают, сколько документов найдено.

Проверяет ли он схемы Kubernetes или Docker Compose?

Он проверяет синтаксис YAML, а не конкретную схему. Файл может быть корректным YAML и всё равно быть отклонён kubectl или docker compose из-за неизвестного поля. Для проверки схем используйте kubectl apply --dry-run=server или docker compose config.

Какая версия YAML используется?

Разбор следует схеме core YAML 1.2, поэтому yes, no, on и off остаются строками. С включённой «Совместимостью с YAML 1.1» вывод заключает эти слова в кавычки, чтобы старые парсеры, такие как PyYAML, тоже читали их как строки.