diff --git a/nvim/.config/nvim/queries/yaml/injections.scm b/nvim/.config/nvim/queries/yaml/injections.scm
index 9830f6c..d5894d7 100644
--- a/nvim/.config/nvim/queries/yaml/injections.scm
+++ b/nvim/.config/nvim/queries/yaml/injections.scm
@@ -6,6 +6,14 @@
     (#set! injection.language "sql")
     (#offset! @injection.content 0 1 0 0)))
 
+(block_mapping_pair
+  key: (flow_node) @_run
+  (#any-of? @_run "documentation")
+  value: (block_node
+    (block_scalar) @injection.content
+    (#set! injection.language "markdown")
+    (#offset! @injection.content 0 1 0 0)))
+
 (block_mapping_pair
   key: (flow_node) @_run
   (#any-of? @_run "query")