diff --git a/docs/spec/reference/cmd.md b/docs/spec/reference/cmd.md
index 9abd9c55a..1d1e6ba8d 100644
--- a/docs/spec/reference/cmd.md
+++ b/docs/spec/reference/cmd.md
@@ -26,19 +26,19 @@ cmd "config" {
 }
 
 cmd "list" {
-  example "Basic usage" r#"
+  example "Basic usage" #"""
     $ mycli list
     FRUIT  COLOR
     apple  red
     banana yellow
-  "#
-  example "JSON output" r#"
+  """#
+  example "JSON output" #"""
     $ mycli list --json
     [
       {"FRUIT": "apple", "COLOR": "red"},
       {"FRUIT": "banana", "COLOR": "yellow"}
     ]
-  "#
+  """#
 }
 ```
 
diff --git a/docs/spec/reference/flag.md b/docs/spec/reference/flag.md
index 4db1fa08c..af41a69cf 100644
--- a/docs/spec/reference/flag.md
+++ b/docs/spec/reference/flag.md
@@ -43,10 +43,11 @@ flag "--env <env>" {
 flag "--file <file>" long_help="longer help for --help (as opposed to -h)"
 // this is equivalent to the above but preferred when a lot of space is needed
 flag "--file <file>" {
-  long_help r#"longer help for --help (as opposed to -h)
-   even
-   more
-   text
-   "#
+  long_help #"""
+    longer help for --help (as opposed to -h)
+    even
+    more
+    text
+    """#
 }
 ```
diff --git a/docs/spec/reference/index.md b/docs/spec/reference/index.md
index 869eecce8..31958295c 100644
--- a/docs/spec/reference/index.md
+++ b/docs/spec/reference/index.md
@@ -36,14 +36,15 @@ This is a tera template that can be used to customize the path for markdown docu
 example, in mise I use the following to convert filenames to snake case:
 
 ```kdl
-source_code_link_template r#"
+source_code_link_template #"""
 {%- set path = path | replace(from='-', to='_') -%}
 {%- if cmd.subcommands | length > 0 -%}
 {%- set path = path | split(pat="/") | slice(end=1) | concat(with="mod.rs") | join(sep="/") -%}
 {%- else -%}
 {%- set path = path ~ ".rs" -%}
 {%- endif -%}
-https://github.com/jdx/mise/blob/main/src/cli/{{path}}"#
+https://github.com/jdx/mise/blob/main/src/cli/{{path}}
+"""#
 ```
 
 ## Examples
diff --git a/examples/mise.usage.kdl b/examples/mise.usage.kdl
index a410862b5..7997266b5 100644
--- a/examples/mise.usage.kdl
+++ b/examples/mise.usage.kdl
@@ -1194,9 +1194,9 @@ case $cur in
     done
     ;;
 esac
-"#
+"""#
 
-complete "installed_tool@version" run=r#"
+complete "installed_tool@version" run=#"""
 cur="{{words[CURRENT]}}"
 case $cur in
   *@*)