blockSequences

Prefer block style sequences over flow style sequences.

✅ This rule is included in the yaml stylistic presets.

Block style sequences use hyphens (-) to denote list items and are generally more readable for multi-item lists. Flow style sequences use brackets ([]) and are more compact but less clear in most cases.

Examples

❌ Incorrect

items: [a, b, c]

nested:
  values: [1, 2, 3]

✅ Correct

items:
  - a
  - b
  - c

nested:
  values:
    - 1
    - 2
    - 3

Options

This rule is not configurable.

Further Reading

• YAML Specification: Block Sequences
• YAML Specification: Flow Sequences

Equivalents in Other Linters

• ESLint: yml/block-sequence