yq/pkg/yqlib/doc/operators/split-into-documents.md

# Split into Documents

This operator splits all matches into separate documents

## Split empty
Running
```bash
yq --null-input 'split_doc'
```
will output
```yaml

```

## Split array
Given a sample.yml file of:
```yaml
- a: cat
- b: dog
```
then
```bash
yq '.[] | split_doc' sample.yml
```
will output
```yaml
a: cat
---
b: dog
```
Update document generation script 2021-11-03 04:00:58 +00:00			`# Split into Documents`

			`This operator splits all matches into separate documents`

			`## Split empty`
			`Running`
			```bash
Added snake_case version of camelCase operators (snake case now prefered) 2022-02-10 22:05:17 +00:00			`yq --null-input 'split_doc'`
Update document generation script 2021-11-03 04:00:58 +00:00			```
			`will output`
			```yaml

			```

			`## Split array`
			`Given a sample.yml file of:`
			```yaml
			`- a: cat`
			`- b: dog`
			```
			`then`
			```bash
Added snake_case version of camelCase operators (snake case now prefered) 2022-02-10 22:05:17 +00:00			`yq '.[] \| split_doc' sample.yml`
Update document generation script 2021-11-03 04:00:58 +00:00			```
			`will output`
			```yaml
			`a: cat`
			`---`
			`b: dog`
			```