Optional
blockOptional
collectionEnforce 'block'
or 'flow'
style on maps and sequences.
Empty collections will always be stringified as {}
or []
.
Default: 'any'
, allowing each node to set its style separately
with its flow: boolean
(default false
) property.
Optional
commentComment stringifier. Output should be valid for the current schema.
By default, empty comment lines are left empty,
lines consisting of a single space are replaced by #
,
and all other lines are prefixed with a #
.
Optional
defaultThe default type of string literal used to stringify implicit key values. Output may use other types if required to fully represent the value.
If null
, the value of defaultStringType
is used.
Default: null
Optional
defaultThe default type of string literal used to stringify values in general. Output may use other types if required to fully represent the value.
Default: 'PLAIN'
Optional
directives?: boolean | nullInclude directives in the output.
true
, at least the document-start marker ---
is always included.
This does not force the %YAML
directive to be included. To do that,
set doc.directives.yaml.explicit = true
.false
, no directives or marker is ever included. If using the %TAG
directive, you are expected to include it manually in the stream before
its use.null
, directives and marker may be included if required.Default: null
Optional
doubleRestrict double-quoted strings to use JSON-compatible syntax.
Default: false
Optional
doubleMinimum length for double-quoted strings to use multiple lines to
represent the value. Ignored if doubleQuotedAsJSON
is set.
Default: 40
Optional
falseString representation for false
.
With the core schema, use 'false'
, 'False'
, or 'FALSE'
.
Default: 'false'
Optional
flowWhen true, a single space of padding will be added inside the delimiters of non-empty single-line flow collections.
Default: true
Optional
indent?: numberThe number of spaces to use when indenting code.
Default: 2
Optional
indentWhether block sequences should be indented.
Default: true
Optional
lineMaximum line width (set to 0
to disable folding).
This is a soft limit, as only double-quoted semantics allow for inserting
a line break in the middle of a word, as well as being influenced by the
minContentWidth
option.
Default: 80
Optional
minMinimum line width for highly-indented content (set to 0
to disable).
Default: 20
Optional
nullString representation for null
.
With the core schema, use 'null'
, 'Null'
, 'NULL'
, '~'
, or an empty
string ''
.
Default: 'null'
Optional
simpleRequire keys to be scalars and to use implicit rather than explicit notation.
Default: false
Optional
singleUse 'single quote' rather than "double quote" where applicable.
Set to false
to disable single quotes completely.
Default: null
Optional
trueString representation for true
.
With the core schema, use 'true'
, 'True'
, or 'TRUE'
.
Default: 'true'
Optional
verifyThe anchor used by an alias must be defined before the alias node. As it's possible for the document to be modified manually, the order may be verified during stringification.
Default: 'true'
Use block quote styles for scalar values where applicable. Set to
false
to disable block quotes completely.Default:
true