diff --git a/yaml.md b/yaml.md
index ec7bd29c4..c0182ad60 100644
--- a/yaml.md
+++ b/yaml.md
@@ -28,8 +28,10 @@ child:
 ### Reference content
 
 ```yaml
-values:
-- &ref Something to reuse
-- *ref  # Reused content
+values: &ref
+  - These values
+  - will be reused below
+  
+other_values:
+  <<: *ref
 ```
-