yq/mkdocs/create.md

Yaml files can be created using the 'new' command. This works in the same way as the write command, but you don't pass in an existing Yaml file. Currently this does not support creating multiple documents in a single yaml file.

yq n <path> <new value>

Creating a simple yaml file

yq n b.c cat

will output:

b:
  c: cat

Creating using a create script

Create scripts follow the same format as the update scripts.

Given a script create_instructions.yaml of:

b.c: 3
b.e[0].name: Howdy Partner

then

yq n -s create_instructions.yaml

will output:

b:
  c: 3
  e:
    - name: Howdy Partner

You can also pipe the instructions in:

cat create_instructions.yaml | yq n -s -

{!snippets/niche.md!}