yq/operators/split-into-documents.md

Split into Documents

This operator splits all matches into separate documents

{% hint style="warning" %} Note that versions prior to 4.18 require the 'eval/e' command to be specified.

yq e <exp> <file> {% endhint %}

Split empty

Running

yq --null-input 'split_doc'

will output

Split array

Given a sample.yml file of:

- a: cat
- b: dog

then

yq '.[] | split_doc' sample.yml

will output

a: cat
---
b: dog