Two YAML documents in one file
Use `---` to separate resources or configs.
yamlANYyamlmulti-documentseparator
yaml
app: api
port: 8080
---
app: worker
port: 9090Notes
Common in Kubernetes and other tools that process a stream of YAML documents.
YAML Multi-Document Streams
Document separators, multi-resource YAML files, and commands for splitting, filtering, and validating streamed YAML.
Export
Copy the compact sheet, download it, or print it.
Download
`D` dense toggle · `C` copy all
Multi-document YAML
Store multiple YAML documents in one file with `---` separators.
Explicit document end marker
Use `...` to mark the end of a document when needed.
yamlANYyamldocument-end
yaml
name: sample
...Notes
The end marker is less common, but it can help in streamed or generated YAML.
Apply a multi-document manifest
Send several Kubernetes resources in one file.
bashANYyamlkubernetesmulti-document
bash
kubectl apply -f stack.yamlNotes
Kubernetes commonly uses one file containing Namespace, Deployment, Service, Ingress, and more.
Split YAML documents into separate files
Write each YAML document to its own output file.
bashANYyamlyqsplit
bash
yq -s '.metadata.name' stack.yamlNotes
Useful when a generated manifest needs to be broken into individual resource files.
Select and inspect documents
Commands for reading the right document from a YAML stream.
bash
yq 'select(documentIndex == 0)' stack.yamlNotes
Helpful when a file contains multiple resources and you only need one.
Select Kubernetes documents by kind
Filter documents in a manifest stream.
bashANYyamlyqkubernetesfilter
bash
yq 'select(.kind == "Deployment")' stack.yamlNotes
A fast way to inspect or extract just one type of resource from a large manifest.
Render Helm templates to YAML
Generate YAML output for inspection before deployment.
bashANYyamlhelmrender
bash
helm template myapp ./chartNotes
Rendered YAML is easier to lint, diff, and review before applying changes.
More in YAML
YAML Config and API Patterns
Application config, OpenAPI, environment settings, and interoperability patterns for YAML across modern tooling.
YAML Validation, Linting, and Troubleshooting
Common syntax errors, duplicate keys, parser checks, and validation workflows for debugging YAML faster.
YAML with yq: Query, Edit, and Transform
High-value yq commands for reading, updating, filtering, converting, and merging YAML in local scripts and CI pipelines.
YAML for DevOps, Kubernetes, and CI
Kubernetes manifests, GitHub Actions, Helm, Compose, and YAML-powered automation workflows with practical validation commands.
YAML Anchors, Aliases, and Merge Keys
Reusable YAML patterns using anchors and aliases, with merge examples and commands for expanding and validating resolved config.
YAML Indentation and Structure
Indentation patterns, nested lists and maps, and practical commands for catching whitespace and structure mistakes.