YAML и конфигурация

Многострочные строки в YAML: синтаксис, примеры переносов и ошибки

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

Опубликовано

Выберите стиль блока

Literal | против Folded >

|

Сохраняет переносы строк

script: |
  npm ci
  npm test

Используйте для скриптов, сертификатов и текста, где важна структура строк.

>

Объединяет обычные строки

summary: >
  Сборка завершена
  без ошибок.

Используйте для читаемого многострочного текста, который должен стать одним предложением.

Выбор варианта

Когда использовать | или >?

  1. Нужны точные переносы строк?Используйте |
  2. Нужен сплошной текст с переносами для чтения?Используйте >

Интерактивный пример

Сравнение модификаторов переносов и отступов в YAML

Выберите пресет блочного скаляра и загрузите его в YAML Formatter для валидации и редактирования.

Выбранный пресет

Сохраните переносы строк с помощью |

Литеральный блок сохраняет переносы строк в небольшом shell-скрипте.

script: |
  npm ci
  npm test

Ожидаемый результат: Корректный YAML со значением script из двух строк.

Почему это не работает

Текст блока должен иметь отступ глубже ключа

Ошибка
message: |
first line
Исправлено
message: |
  first line

Проверьте ваш YAML

Форматирование многострочного YAML

Проверьте отступы и стиль блочных скаляров в онлайн-форматтере YAML.

Открыть YAML Formatter →