diff --git a/cli/usage.usage.kdl b/cli/usage.usage.kdl
index 5bea24b1..2697a4ef 100644
--- a/cli/usage.usage.kdl
+++ b/cli/usage.usage.kdl
@@ -7,7 +7,14 @@ usage "Usage: usage-cli [OPTIONS] [COMPLETIONS] <COMMAND>"
 flag --usage-spec help="Outputs a `usage.kdl` spec for this CLI itself"
 arg "[COMPLETIONS]" help="Outputs completions for the specified shell for completing the `usage` CLI itself" required=#false
 cmd bash help="Execute a shell script using bash" {
-    long_help "Execute a shell script with the specified shell\n\nTypically, this will be called by a script's shebang.\n\nIf using `var=#true` on args/flags, they will be joined with spaces using `shell_words::join()`\nto properly escape and quote values with spaces in them."
+    long_help #"""
+Execute a shell script with the specified shell
+
+Typically, this will be called by a script's shebang.
+
+If using `var=#true` on args/flags, they will be joined with spaces using `shell_words::join()`
+to properly escape and quote values with spaces in them.
+"""#
     flag -h help="Show help"
     flag --help help="Show help"
     arg <SCRIPT>
@@ -15,7 +22,11 @@ cmd bash help="Execute a shell script using bash" {
 }
 cmd complete-word help="Generate shell completion candidates for a partial command line" {
     alias cw
-    long_help "Generate shell completion candidates for a partial command line\n\nThis is used internally by shell completion scripts to provide intelligent completions for commands, flags, and arguments."
+    long_help #"""
+Generate shell completion candidates for a partial command line
+
+This is used internally by shell completion scripts to provide intelligent completions for commands, flags, and arguments.
+"""#
     flag "-f --file" help="Usage spec file or script with usage shebang, use \"-\" to read from stdin" {
         arg <FILE>
     }
@@ -41,7 +52,14 @@ cmd exec help="Execute a script, parsing args and exposing them as environment v
     arg "[ARGS]…" help="arguments to pass to script" required=#false var=#true
 }
 cmd fish help="Execute a shell script using fish" {
-    long_help "Execute a shell script with the specified shell\n\nTypically, this will be called by a script's shebang.\n\nIf using `var=#true` on args/flags, they will be joined with spaces using `shell_words::join()`\nto properly escape and quote values with spaces in them."
+    long_help #"""
+Execute a shell script with the specified shell
+
+Typically, this will be called by a script's shebang.
+
+If using `var=#true` on args/flags, they will be joined with spaces using `shell_words::join()`
+to properly escape and quote values with spaces in them.
+"""#
     flag -h help="Show help"
     flag --help help="Show help"
     arg <SCRIPT>
@@ -59,10 +77,18 @@ cmd generate subcommand_required=#true help="Generate completions, documentation
             arg <CACHE_KEY>
         }
         flag --include-bash-completion-lib help="Include https://github.com/scop/bash-completion" {
-            long_help "Include https://github.com/scop/bash-completion\n\nThis is required for usage completions to work in bash, but the user may already provide it"
+            long_help #"""
+Include https://github.com/scop/bash-completion
+
+This is required for usage completions to work in bash, but the user may already provide it
+"""#
         }
         flag --usage-bin help="Override the bin used for calling back to usage-cli" default=usage {
-            long_help "Override the bin used for calling back to usage-cli\n\nYou may need to set this if you have a different bin named \"usage\""
+            long_help #"""
+Override the bin used for calling back to usage-cli
+
+You may need to set this if you have a different bin named "usage"
+"""#
             arg <USAGE_BIN>
         }
         flag --usage-cmd help="A command which generates a usage spec e.g.: `mycli --usage` or `mycli completion usage` Defaults to \"$bin --usage\"" {
@@ -76,9 +102,17 @@ cmd generate subcommand_required=#true help="Generate completions, documentation
     cmd completion-init help="Generate a shell init script that auto-completes any usage shebang script on $PATH" {
         alias ci
         alias init completions-init hide=#true
-        long_help "Generate a shell init script that auto-completes any usage shebang script on $PATH\n\nSource the output once from your shell rc (e.g. ~/.bashrc) to enable tab-completion for any executable whose first line is a `usage` shebang — no per-script `usage g completion` step required."
+        long_help #"""
+Generate a shell init script that auto-completes any usage shebang script on $PATH
+
+Source the output once from your shell rc (e.g. ~/.bashrc) to enable tab-completion for any executable whose first line is a `usage` shebang — no per-script `usage g completion` step required.
+"""#
         flag --usage-bin help="Override the bin used for calling back to usage-cli" default=usage {
-            long_help "Override the bin used for calling back to usage-cli\n\nYou may need to set this if you have a different bin named \"usage\""
+            long_help #"""
+Override the bin used for calling back to usage-cli
+
+You may need to set this if you have a different bin named "usage"
+"""#
             arg <USAGE_BIN>
         }
         arg <SHELL> help="Shell to generate the init script for" {
@@ -113,7 +147,11 @@ cmd generate subcommand_required=#true help="Generate completions, documentation
             arg <OUT_FILE>
         }
         flag "-s --section" help="Manual section number (default: 1)" default="1" {
-            long_help "Manual section number (default: 1)\n\nCommon sections: - 1: User commands - 5: File formats - 7: Miscellaneous - 8: System administration commands"
+            long_help #"""
+Manual section number (default: 1)
+
+Common sections: - 1: User commands - 5: File formats - 7: Miscellaneous - 8: System administration commands
+"""#
             arg <SECTION>
         }
     }
@@ -146,14 +184,28 @@ cmd lint help="Lint a usage spec file for common issues" {
     arg <FILE> help="A usage spec file to lint, use \"-\" to read from stdin"
 }
 cmd powershell help="Execute a shell script using PowerShell" {
-    long_help "Execute a shell script with the specified shell\n\nTypically, this will be called by a script's shebang.\n\nIf using `var=#true` on args/flags, they will be joined with spaces using `shell_words::join()`\nto properly escape and quote values with spaces in them."
+    long_help #"""
+Execute a shell script with the specified shell
+
+Typically, this will be called by a script's shebang.
+
+If using `var=#true` on args/flags, they will be joined with spaces using `shell_words::join()`
+to properly escape and quote values with spaces in them.
+"""#
     flag -h help="Show help"
     flag --help help="Show help"
     arg <SCRIPT>
     arg "[ARGS]…" help="Arguments to pass to script" required=#false var=#true
 }
 cmd zsh help="Execute a shell script using zsh" {
-    long_help "Execute a shell script with the specified shell\n\nTypically, this will be called by a script's shebang.\n\nIf using `var=#true` on args/flags, they will be joined with spaces using `shell_words::join()`\nto properly escape and quote values with spaces in them."
+    long_help #"""
+Execute a shell script with the specified shell
+
+Typically, this will be called by a script's shebang.
+
+If using `var=#true` on args/flags, they will be joined with spaces using `shell_words::join()`
+to properly escape and quote values with spaces in them.
+"""#
     flag -h help="Show help"
     flag --help help="Show help"
     arg <SCRIPT>
diff --git a/lib/src/complete/snapshots/usage__complete__bash__tests__complete_bash-3.snap b/lib/src/complete/snapshots/usage__complete__bash__tests__complete_bash-3.snap
index f364d6ba..0e3a3d3f 100644
--- a/lib/src/complete/snapshots/usage__complete__bash__tests__complete_bash-3.snap
+++ b/lib/src/complete/snapshots/usage__complete__bash__tests__complete_bash-3.snap
@@ -20,7 +20,29 @@ bin mycli
 source_code_link_template "https://github.com/jdx/mise/blob/main/src/cli/{{path}}.rs"
 flag --flag1 help="flag1 description"
 flag --flag2 help="flag2 description" {
-    long_help "flag2 long description\n\nincludes a code block:\n\n    $ echo hello world\n    hello world\n\n    more code\n\nExamples:\n\n    # run with no arguments to use the interactive selector\n    $ mise use\n\n    # set the current version of node to 20.x in mise.toml of current directory\n    # will write the fuzzy version (e.g.: 20)\n\nsome docs\n\n    $ echo hello world\n    hello world"
+    long_help #"""
+flag2 long description
+
+includes a code block:
+
+    $ echo hello world
+    hello world
+
+    more code
+
+Examples:
+
+    # run with no arguments to use the interactive selector
+    $ mise use
+
+    # set the current version of node to 20.x in mise.toml of current directory
+    # will write the fuzzy version (e.g.: 20)
+
+some docs
+
+    $ echo hello world
+    hello world
+"""#
 }
 flag --flag3 help="flag3 description" negate=--no-flag3
 flag --with-default default="default value"
@@ -36,7 +58,11 @@ arg "[arg2]" help="arg2 description" required=#false default="default value" {
 arg <arg3> help="arg3 description" help_long="arg3 long description"
 arg <argrest>… var=#true
 arg "[with-default]" required=#false default="default value"
-complete plugin run="echo \"plugin-1\nplugin-2\nplugin-3\""
+complete plugin run=#"""
+echo "plugin-1
+plugin-2
+plugin-3"
+"""#
 cmd plugin {
     cmd install {
         long_help "install a plugin"
diff --git a/lib/src/complete/snapshots/usage__complete__fish__tests__complete_fish-3.snap b/lib/src/complete/snapshots/usage__complete__fish__tests__complete_fish-3.snap
index 7f8cb20e..3fe07dfb 100644
--- a/lib/src/complete/snapshots/usage__complete__fish__tests__complete_fish-3.snap
+++ b/lib/src/complete/snapshots/usage__complete__fish__tests__complete_fish-3.snap
@@ -17,7 +17,29 @@ bin mycli
 source_code_link_template "https://github.com/jdx/mise/blob/main/src/cli/{{path}}.rs"
 flag --flag1 help="flag1 description"
 flag --flag2 help="flag2 description" {
-    long_help "flag2 long description\n\nincludes a code block:\n\n    $ echo hello world\n    hello world\n\n    more code\n\nExamples:\n\n    # run with no arguments to use the interactive selector\n    $ mise use\n\n    # set the current version of node to 20.x in mise.toml of current directory\n    # will write the fuzzy version (e.g.: 20)\n\nsome docs\n\n    $ echo hello world\n    hello world"
+    long_help #"""
+flag2 long description
+
+includes a code block:
+
+    $ echo hello world
+    hello world
+
+    more code
+
+Examples:
+
+    # run with no arguments to use the interactive selector
+    $ mise use
+
+    # set the current version of node to 20.x in mise.toml of current directory
+    # will write the fuzzy version (e.g.: 20)
+
+some docs
+
+    $ echo hello world
+    hello world
+"""#
 }
 flag --flag3 help="flag3 description" negate=--no-flag3
 flag --with-default default="default value"
@@ -33,7 +55,11 @@ arg "[arg2]" help="arg2 description" required=#false default="default value" {
 arg <arg3> help="arg3 description" help_long="arg3 long description"
 arg <argrest>… var=#true
 arg "[with-default]" required=#false default="default value"
-complete plugin run="echo \"plugin-1\nplugin-2\nplugin-3\""
+complete plugin run=#"""
+echo "plugin-1
+plugin-2
+plugin-3"
+"""#
 cmd plugin {
     cmd install {
         long_help "install a plugin"
diff --git a/lib/src/complete/snapshots/usage__complete__nu__tests__complete_nu-3.snap b/lib/src/complete/snapshots/usage__complete__nu__tests__complete_nu-3.snap
index b977379a..377c0c8a 100644
--- a/lib/src/complete/snapshots/usage__complete__nu__tests__complete_nu-3.snap
+++ b/lib/src/complete/snapshots/usage__complete__nu__tests__complete_nu-3.snap
@@ -9,7 +9,29 @@ bin mycli
 source_code_link_template "https://github.com/jdx/mise/blob/main/src/cli/{{path}}.rs"
 flag --flag1 help="flag1 description"
 flag --flag2 help="flag2 description" {
-    long_help "flag2 long description\n\nincludes a code block:\n\n    $ echo hello world\n    hello world\n\n    more code\n\nExamples:\n\n    # run with no arguments to use the interactive selector\n    $ mise use\n\n    # set the current version of node to 20.x in mise.toml of current directory\n    # will write the fuzzy version (e.g.: 20)\n\nsome docs\n\n    $ echo hello world\n    hello world"
+    long_help #"""
+flag2 long description
+
+includes a code block:
+
+    $ echo hello world
+    hello world
+
+    more code
+
+Examples:
+
+    # run with no arguments to use the interactive selector
+    $ mise use
+
+    # set the current version of node to 20.x in mise.toml of current directory
+    # will write the fuzzy version (e.g.: 20)
+
+some docs
+
+    $ echo hello world
+    hello world
+"""#
 }
 flag --flag3 help="flag3 description" negate=--no-flag3
 flag --with-default default="default value"
@@ -25,7 +47,11 @@ arg "[arg2]" help="arg2 description" required=#false default="default value" {
 arg <arg3> help="arg3 description" help_long="arg3 long description"
 arg <argrest>… var=#true
 arg "[with-default]" required=#false default="default value"
-complete plugin run="echo \"plugin-1\nplugin-2\nplugin-3\""
+complete plugin run=#"""
+echo "plugin-1
+plugin-2
+plugin-3"
+"""#
 cmd plugin {
     cmd install {
         long_help "install a plugin"
diff --git a/lib/src/complete/snapshots/usage__complete__powershell__tests__complete_powershell-3.snap b/lib/src/complete/snapshots/usage__complete__powershell__tests__complete_powershell-3.snap
index 21206128..ef861a78 100644
--- a/lib/src/complete/snapshots/usage__complete__powershell__tests__complete_powershell-3.snap
+++ b/lib/src/complete/snapshots/usage__complete__powershell__tests__complete_powershell-3.snap
@@ -21,7 +21,29 @@ bin mycli
 source_code_link_template "https://github.com/jdx/mise/blob/main/src/cli/{{path}}.rs"
 flag --flag1 help="flag1 description"
 flag --flag2 help="flag2 description" {
-    long_help "flag2 long description\n\nincludes a code block:\n\n    $ echo hello world\n    hello world\n\n    more code\n\nExamples:\n\n    # run with no arguments to use the interactive selector\n    $ mise use\n\n    # set the current version of node to 20.x in mise.toml of current directory\n    # will write the fuzzy version (e.g.: 20)\n\nsome docs\n\n    $ echo hello world\n    hello world"
+    long_help #"""
+flag2 long description
+
+includes a code block:
+
+    $ echo hello world
+    hello world
+
+    more code
+
+Examples:
+
+    # run with no arguments to use the interactive selector
+    $ mise use
+
+    # set the current version of node to 20.x in mise.toml of current directory
+    # will write the fuzzy version (e.g.: 20)
+
+some docs
+
+    $ echo hello world
+    hello world
+"""#
 }
 flag --flag3 help="flag3 description" negate=--no-flag3
 flag --with-default default="default value"
@@ -37,7 +59,11 @@ arg "[arg2]" help="arg2 description" required=#false default="default value" {
 arg <arg3> help="arg3 description" help_long="arg3 long description"
 arg <argrest>… var=#true
 arg "[with-default]" required=#false default="default value"
-complete plugin run="echo \"plugin-1\nplugin-2\nplugin-3\""
+complete plugin run=#"""
+echo "plugin-1
+plugin-2
+plugin-3"
+"""#
 cmd plugin {
     cmd install {
         long_help "install a plugin"
diff --git a/lib/src/complete/snapshots/usage__complete__zsh__tests__complete_zsh-3.snap b/lib/src/complete/snapshots/usage__complete__zsh__tests__complete_zsh-3.snap
index afbe39e5..c52bf4b6 100644
--- a/lib/src/complete/snapshots/usage__complete__zsh__tests__complete_zsh-3.snap
+++ b/lib/src/complete/snapshots/usage__complete__zsh__tests__complete_zsh-3.snap
@@ -24,7 +24,29 @@ bin mycli
 source_code_link_template "https://github.com/jdx/mise/blob/main/src/cli/{{path}}.rs"
 flag --flag1 help="flag1 description"
 flag --flag2 help="flag2 description" {
-    long_help "flag2 long description\n\nincludes a code block:\n\n    $ echo hello world\n    hello world\n\n    more code\n\nExamples:\n\n    # run with no arguments to use the interactive selector\n    $ mise use\n\n    # set the current version of node to 20.x in mise.toml of current directory\n    # will write the fuzzy version (e.g.: 20)\n\nsome docs\n\n    $ echo hello world\n    hello world"
+    long_help #"""
+flag2 long description
+
+includes a code block:
+
+    $ echo hello world
+    hello world
+
+    more code
+
+Examples:
+
+    # run with no arguments to use the interactive selector
+    $ mise use
+
+    # set the current version of node to 20.x in mise.toml of current directory
+    # will write the fuzzy version (e.g.: 20)
+
+some docs
+
+    $ echo hello world
+    hello world
+"""#
 }
 flag --flag3 help="flag3 description" negate=--no-flag3
 flag --with-default default="default value"
@@ -40,7 +62,11 @@ arg "[arg2]" help="arg2 description" required=#false default="default value" {
 arg <arg3> help="arg3 description" help_long="arg3 long description"
 arg <argrest>… var=#true
 arg "[with-default]" required=#false default="default value"
-complete plugin run="echo \"plugin-1\nplugin-2\nplugin-3\""
+complete plugin run=#"""
+echo "plugin-1
+plugin-2
+plugin-3"
+"""#
 cmd plugin {
     cmd install {
         long_help "install a plugin"
diff --git a/lib/src/spec/arg.rs b/lib/src/spec/arg.rs
index d5e5cdb2..bec0ab4a 100644
--- a/lib/src/spec/arg.rs
+++ b/lib/src/spec/arg.rs
@@ -7,7 +7,7 @@ use std::str::FromStr;
 use crate::error::UsageErr;
 use crate::spec::builder::SpecArgBuilder;
 use crate::spec::context::ParsingContext;
-use crate::spec::helpers::NodeHelper;
+use crate::spec::helpers::{string_entry, NodeHelper};
 use crate::spec::is_false;
 use crate::{string, SpecChoices};
 
@@ -176,13 +176,13 @@ impl From<&SpecArg> for KdlNode {
         let mut node = KdlNode::new("arg");
         node.push(KdlEntry::new(arg.usage()));
         if let Some(desc) = &arg.help {
-            node.push(KdlEntry::new_prop("help", desc.clone()));
+            node.push(string_entry(Some("help"), desc));
         }
         if let Some(desc) = &arg.help_long {
-            node.push(KdlEntry::new_prop("help_long", desc.clone()));
+            node.push(string_entry(Some("help_long"), desc));
         }
         if let Some(desc) = &arg.help_md {
-            node.push(KdlEntry::new_prop("help_md", desc.clone()));
+            node.push(string_entry(Some("help_md"), desc));
         }
         if !arg.required {
             node.push(KdlEntry::new_prop("required", false));
@@ -211,7 +211,7 @@ impl From<&SpecArg> for KdlNode {
         if !arg.default.is_empty() {
             if arg.default.len() == 1 {
                 // Single value: use property default="bar"
-                node.push(KdlEntry::new_prop("default", arg.default[0].clone()));
+                node.push(string_entry(Some("default"), &arg.default[0]));
             } else {
                 // Multiple values: use child node default { "xyz"; "bar" }
                 let children = node.children_mut().get_or_insert_with(KdlDocument::new);
@@ -228,7 +228,7 @@ impl From<&SpecArg> for KdlNode {
             }
         }
         if let Some(env) = &arg.env {
-            node.push(KdlEntry::new_prop("env", env.clone()));
+            node.push(string_entry(Some("env"), env));
         }
         if let Some(choices) = &arg.choices {
             let children = node.children_mut().get_or_insert_with(KdlDocument::new);
diff --git a/lib/src/spec/cmd.rs b/lib/src/spec/cmd.rs
index cd298d87..48ceaa25 100644
--- a/lib/src/spec/cmd.rs
+++ b/lib/src/spec/cmd.rs
@@ -5,13 +5,13 @@ use crate::error::UsageErr;
 use crate::sh::sh;
 use crate::spec::builder::SpecCommandBuilder;
 use crate::spec::context::ParsingContext;
-use crate::spec::helpers::NodeHelper;
+use crate::spec::helpers::{string_entry, NodeHelper};
 use crate::spec::is_false;
 use crate::spec::mount::SpecMount;
 use crate::{Spec, SpecArg, SpecComplete, SpecFlag};
 use indexmap::IndexMap;
 use itertools::Itertools;
-use kdl::{KdlDocument, KdlEntry, KdlNode, KdlValue};
+use kdl::{KdlDocument, KdlEntry, KdlNode};
 use serde::Serialize;
 
 /// A CLI command or subcommand specification.
@@ -154,15 +154,15 @@ impl SpecExample {
 impl From<&SpecExample> for KdlNode {
     fn from(example: &SpecExample) -> KdlNode {
         let mut node = KdlNode::new("example");
-        node.push(KdlEntry::new(example.code.clone()));
+        node.push(string_entry(None, &example.code));
         if let Some(header) = &example.header {
-            node.push(KdlEntry::new_prop("header", header.clone()));
+            node.push(string_entry(Some("header"), header));
         }
         if let Some(help) = &example.help {
-            node.push(KdlEntry::new_prop("help", help.clone()));
+            node.push(string_entry(Some("help"), help));
         }
         if !example.lang.is_empty() {
-            node.push(KdlEntry::new_prop("lang", example.lang.clone()));
+            node.push(string_entry(Some("lang"), &example.lang));
         }
         node
     }
@@ -487,53 +487,56 @@ impl From<&SpecCommand> for KdlNode {
             children.nodes_mut().push(aliases);
         }
         if let Some(help) = &cmd.help {
-            node.entries_mut()
-                .push(KdlEntry::new_prop("help", help.clone()));
+            node.entries_mut().push(string_entry(Some("help"), help));
         }
         if let Some(help) = &cmd.help_long {
             let children = node.children_mut().get_or_insert_with(KdlDocument::new);
             let mut node = KdlNode::new("long_help");
-            node.insert(0, KdlValue::String(help.clone()));
+            node.push(string_entry(None, help));
             children.nodes_mut().push(node);
         }
         if let Some(help) = &cmd.help_md {
             let children = node.children_mut().get_or_insert_with(KdlDocument::new);
             let mut node = KdlNode::new("help_md");
-            node.insert(0, KdlValue::String(help.clone()));
+            node.push(string_entry(None, help));
             children.nodes_mut().push(node);
         }
         if let Some(help) = &cmd.before_help {
             node.entries_mut()
-                .push(KdlEntry::new_prop("before_help", help.clone()));
+                .push(string_entry(Some("before_help"), help));
         }
         if let Some(help) = &cmd.before_help_long {
             let children = node.children_mut().get_or_insert_with(KdlDocument::new);
             let mut node = KdlNode::new("before_long_help");
-            node.insert(0, KdlValue::String(help.clone()));
+            node.push(string_entry(None, help));
             children.nodes_mut().push(node);
         }
         if let Some(help) = &cmd.before_help_md {
             let children = node.children_mut().get_or_insert_with(KdlDocument::new);
             let mut node = KdlNode::new("before_help_md");
-            node.insert(0, KdlValue::String(help.clone()));
+            node.push(string_entry(None, help));
             children.nodes_mut().push(node);
         }
         if let Some(help) = &cmd.after_help {
             node.entries_mut()
-                .push(KdlEntry::new_prop("after_help", help.clone()));
+                .push(string_entry(Some("after_help"), help));
         }
         if let Some(help) = &cmd.after_help_long {
             let children = node.children_mut().get_or_insert_with(KdlDocument::new);
             let mut node = KdlNode::new("after_long_help");
-            node.insert(0, KdlValue::String(help.clone()));
+            node.push(string_entry(None, help));
             children.nodes_mut().push(node);
         }
         if let Some(help) = &cmd.after_help_md {
             let children = node.children_mut().get_or_insert_with(KdlDocument::new);
             let mut node = KdlNode::new("after_help_md");
-            node.insert(0, KdlValue::String(help.clone()));
+            node.push(string_entry(None, help));
             children.nodes_mut().push(node);
         }
+        if let Some(deprecated) = &cmd.deprecated {
+            node.entries_mut()
+                .push(string_entry(Some("deprecated"), deprecated));
+        }
         for flag in &cmd.flags {
             let children = node.children_mut().get_or_insert_with(KdlDocument::new);
             children.nodes_mut().push(flag.into());
diff --git a/lib/src/spec/complete.rs b/lib/src/spec/complete.rs
index 359a9a46..d0f1da93 100644
--- a/lib/src/spec/complete.rs
+++ b/lib/src/spec/complete.rs
@@ -3,7 +3,7 @@ use serde::{Deserialize, Serialize};
 
 use crate::error::UsageErr;
 use crate::spec::context::ParsingContext;
-use crate::spec::helpers::NodeHelper;
+use crate::spec::helpers::{string_entry, NodeHelper};
 use crate::spec::is_false;
 
 #[derive(Debug, Default, Clone, Serialize, Deserialize)]
@@ -47,12 +47,12 @@ impl SpecComplete {
 impl From<&SpecComplete> for KdlNode {
     fn from(complete: &SpecComplete) -> Self {
         let mut node = KdlNode::new("complete");
-        node.push(KdlEntry::new(complete.name.clone()));
+        node.push(string_entry(None, &complete.name));
         if let Some(run) = &complete.run {
-            node.push(KdlEntry::new_prop("run", run.clone()));
+            node.push(string_entry(Some("run"), run));
         }
         if let Some(type_) = &complete.type_ {
-            node.push(KdlEntry::new_prop("type", type_.clone()));
+            node.push(string_entry(Some("type"), type_));
         }
         if complete.descriptions {
             node.push(KdlEntry::new_prop("descriptions", true));
diff --git a/lib/src/spec/config.rs b/lib/src/spec/config.rs
index 05861319..57780ee4 100644
--- a/lib/src/spec/config.rs
+++ b/lib/src/spec/config.rs
@@ -6,7 +6,7 @@ use serde::Serialize;
 use crate::error::UsageErr;
 use crate::spec::context::ParsingContext;
 use crate::spec::data_types::SpecDataTypes;
-use crate::spec::helpers::NodeHelper;
+use crate::spec::helpers::{string_entry, NodeHelper};
 
 #[derive(Debug, Default, Clone, Serialize)]
 pub struct SpecConfig {
@@ -72,19 +72,19 @@ impl SpecConfigProp {
         let mut node = KdlNode::new("prop");
         node.push(KdlEntry::new(key));
         if let Some(default) = &self.default {
-            node.push(KdlEntry::new_prop("default", default.clone()));
+            node.push(string_entry(Some("default"), default));
         }
         if let Some(default_note) = &self.default_note {
-            node.push(KdlEntry::new_prop("default_note", default_note.clone()));
+            node.push(string_entry(Some("default_note"), default_note));
         }
         if let Some(env) = &self.env {
-            node.push(KdlEntry::new_prop("env", env.clone()));
+            node.push(string_entry(Some("env"), env));
         }
         if let Some(help) = &self.help {
-            node.push(KdlEntry::new_prop("help", help.clone()));
+            node.push(string_entry(Some("help"), help));
         }
         if let Some(long_help) = &self.long_help {
-            node.push(KdlEntry::new_prop("long_help", long_help.clone()));
+            node.push(string_entry(Some("long_help"), long_help));
         }
         node
     }
diff --git a/lib/src/spec/flag.rs b/lib/src/spec/flag.rs
index fffd352e..561c2790 100644
--- a/lib/src/spec/flag.rs
+++ b/lib/src/spec/flag.rs
@@ -9,7 +9,7 @@ use crate::error::UsageErr::InvalidFlag;
 use crate::error::{Result, UsageErr};
 use crate::spec::builder::SpecFlagBuilder;
 use crate::spec::context::ParsingContext;
-use crate::spec::helpers::NodeHelper;
+use crate::spec::helpers::{string_entry, NodeHelper};
 use crate::spec::is_false;
 use crate::{string, SpecArg, SpecChoices};
 
@@ -226,18 +226,18 @@ impl From<&SpecFlag> for KdlNode {
             .join(" ");
         node.push(KdlEntry::new(name));
         if let Some(desc) = &flag.help {
-            node.push(KdlEntry::new_prop("help", desc.clone()));
+            node.push(string_entry(Some("help"), desc));
         }
         if let Some(desc) = &flag.help_long {
             let children = node.children_mut().get_or_insert_with(KdlDocument::new);
             let mut node = KdlNode::new("long_help");
-            node.entries_mut().push(KdlEntry::new(desc.clone()));
+            node.push(string_entry(None, desc));
             children.nodes_mut().push(node);
         }
         if let Some(desc) = &flag.help_md {
             let children = node.children_mut().get_or_insert_with(KdlDocument::new);
             let mut node = KdlNode::new("help_md");
-            node.entries_mut().push(KdlEntry::new(desc.clone()));
+            node.push(string_entry(None, desc));
             children.nodes_mut().push(node);
         }
         if flag.required {
@@ -262,13 +262,13 @@ impl From<&SpecFlag> for KdlNode {
             node.push(KdlEntry::new_prop("count", true));
         }
         if let Some(negate) = &flag.negate {
-            node.push(KdlEntry::new_prop("negate", negate.clone()));
+            node.push(string_entry(Some("negate"), negate));
         }
         if let Some(env) = &flag.env {
-            node.push(KdlEntry::new_prop("env", env.clone()));
+            node.push(string_entry(Some("env"), env));
         }
         if let Some(deprecated) = &flag.deprecated {
-            node.push(KdlEntry::new_prop("deprecated", deprecated.clone()));
+            node.push(string_entry(Some("deprecated"), deprecated));
         }
         // Serialize default values
         if !flag.default.is_empty() {
diff --git a/lib/src/spec/helpers.rs b/lib/src/spec/helpers.rs
index 394b6e73..04070206 100644
--- a/lib/src/spec/helpers.rs
+++ b/lib/src/spec/helpers.rs
@@ -1,5 +1,5 @@
 use indexmap::IndexMap;
-use kdl::{KdlEntry, KdlNode, KdlValue};
+use kdl::{KdlEntry, KdlEntryFormat, KdlNode, KdlValue};
 use miette::SourceSpan;
 use std::fmt::Debug;
 use std::ops::RangeBounds;
@@ -7,6 +7,47 @@ use std::ops::RangeBounds;
 use crate::error::UsageErr;
 use crate::spec::context::ParsingContext;
 
+/// Compute the number of `#` characters needed for a raw multiline string.
+/// We need `n` such that the value does not contain `"""` followed by `n` `#` characters.
+fn raw_multiline_hash_count(value: &str) -> usize {
+    let mut max_count = 0;
+    for line in value.lines() {
+        for (idx, _) in line.match_indices("\"\"\"") {
+            let after = &line[idx + 3..];
+            let count = after.chars().take_while(|&c| c == '#').count();
+            max_count = max_count.max(count);
+        }
+    }
+    max_count + 1
+}
+
+/// Create a KdlEntry for a string value, using KDL raw multiline string syntax (`#"""..."""#`)
+/// when the value contains newlines. The number of `#` characters is automatically determined
+/// to ensure the value can be embedded safely.
+pub(crate) fn string_entry(key: Option<&str>, value: &str) -> KdlEntry {
+    let mut entry = match key {
+        Some(k) => KdlEntry::new_prop(k, KdlValue::String(value.to_string())),
+        None => KdlEntry::new(KdlValue::String(value.to_string())),
+    };
+    if value.contains('\n') {
+        let n = raw_multiline_hash_count(value);
+        let hashes = "#".repeat(n);
+        let repr = format!("{hashes}\"\"\"\n{value}\n\"\"\"{hashes}");
+        entry.set_format(KdlEntryFormat {
+            value_repr: repr,
+            leading: " ".into(),
+            trailing: "".into(),
+            after_ty: "".into(),
+            before_ty_name: "".into(),
+            after_ty_name: "".into(),
+            after_key: "".into(),
+            after_eq: "".into(),
+            autoformat_keep: true,
+        });
+    }
+    entry
+}
+
 #[derive(Debug)]
 pub struct NodeHelper<'a> {
     pub(crate) node: &'a KdlNode,
diff --git a/lib/src/spec/mod.rs b/lib/src/spec/mod.rs
index f5563605..336881a5 100644
--- a/lib/src/spec/mod.rs
+++ b/lib/src/spec/mod.rs
@@ -11,7 +11,7 @@ pub mod helpers;
 pub mod mount;
 
 use indexmap::IndexMap;
-use kdl::{KdlDocument, KdlEntry, KdlNode, KdlValue};
+use kdl::{KdlDocument, KdlEntry, KdlNode};
 use log::{info, warn};
 use serde::Serialize;
 use std::fmt::{Display, Formatter};
@@ -24,7 +24,7 @@ use crate::error::UsageErr;
 use crate::spec::cmd::{SpecCommand, SpecExample};
 use crate::spec::config::SpecConfig;
 use crate::spec::context::ParsingContext;
-use crate::spec::helpers::NodeHelper;
+use crate::spec::helpers::{string_entry, NodeHelper};
 use crate::{SpecArg, SpecComplete, SpecFlag};
 
 #[derive(Debug, Default, Clone, Serialize)]
@@ -358,67 +358,67 @@ impl Display for Spec {
         let nodes = &mut doc.nodes_mut();
         if !self.name.is_empty() {
             let mut node = KdlNode::new("name");
-            node.push(KdlEntry::new(self.name.clone()));
+            node.push(string_entry(None, &self.name));
             nodes.push(node);
         }
         if !self.bin.is_empty() {
             let mut node = KdlNode::new("bin");
-            node.push(KdlEntry::new(self.bin.clone()));
+            node.push(string_entry(None, &self.bin));
             nodes.push(node);
         }
         if let Some(version) = &self.version {
             let mut node = KdlNode::new("version");
-            node.push(KdlEntry::new(version.clone()));
+            node.push(string_entry(None, version));
             nodes.push(node);
         }
         if let Some(author) = &self.author {
             let mut node = KdlNode::new("author");
-            node.push(KdlEntry::new(author.clone()));
+            node.push(string_entry(None, author));
             nodes.push(node);
         }
         if let Some(about) = &self.about {
             let mut node = KdlNode::new("about");
-            node.push(KdlEntry::new(about.clone()));
+            node.push(string_entry(None, about));
             nodes.push(node);
         }
         if let Some(source_code_link_template) = &self.source_code_link_template {
             let mut node = KdlNode::new("source_code_link_template");
-            node.push(KdlEntry::new(source_code_link_template.clone()));
+            node.push(string_entry(None, source_code_link_template));
             nodes.push(node);
         }
         if let Some(about_md) = &self.about_md {
             let mut node = KdlNode::new("about_md");
-            node.push(KdlEntry::new(KdlValue::String(about_md.clone())));
+            node.push(string_entry(None, about_md));
             nodes.push(node);
         }
         if let Some(long_about) = &self.about_long {
             let mut node = KdlNode::new("long_about");
-            node.push(KdlEntry::new(KdlValue::String(long_about.clone())));
+            node.push(string_entry(None, long_about));
             nodes.push(node);
         }
         if let Some(license) = &self.license {
             let mut node = KdlNode::new("license");
-            node.push(KdlEntry::new(KdlValue::String(license.clone())));
+            node.push(string_entry(None, license));
             nodes.push(node);
         }
         if let Some(before_help) = &self.before_help {
             let mut node = KdlNode::new("before_help");
-            node.push(KdlEntry::new(KdlValue::String(before_help.clone())));
+            node.push(string_entry(None, before_help));
             nodes.push(node);
         }
         if let Some(after_help) = &self.after_help {
             let mut node = KdlNode::new("after_help");
-            node.push(KdlEntry::new(KdlValue::String(after_help.clone())));
+            node.push(string_entry(None, after_help));
             nodes.push(node);
         }
         if let Some(before_help_long) = &self.before_help_long {
             let mut node = KdlNode::new("before_long_help");
-            node.push(KdlEntry::new(KdlValue::String(before_help_long.clone())));
+            node.push(string_entry(None, before_help_long));
             nodes.push(node);
         }
         if let Some(after_help_long) = &self.after_help_long {
             let mut node = KdlNode::new("after_long_help");
-            node.push(KdlEntry::new(KdlValue::String(after_help_long.clone())));
+            node.push(string_entry(None, after_help_long));
             nodes.push(node);
         }
         if let Some(disable_help) = self.disable_help {
@@ -428,17 +428,17 @@ impl Display for Spec {
         }
         if let Some(min_usage_version) = &self.min_usage_version {
             let mut node = KdlNode::new("min_usage_version");
-            node.push(KdlEntry::new(min_usage_version.clone()));
+            node.push(string_entry(None, min_usage_version));
             nodes.push(node);
         }
         if let Some(default_subcommand) = &self.default_subcommand {
             let mut node = KdlNode::new("default_subcommand");
-            node.push(KdlEntry::new(default_subcommand.clone()));
+            node.push(string_entry(None, default_subcommand));
             nodes.push(node);
         }
         if !self.usage.is_empty() {
             let mut node = KdlNode::new("usage");
-            node.push(KdlEntry::new(self.usage.clone()));
+            node.push(string_entry(None, &self.usage));
             nodes.push(node);
         }
         for flag in self.cmd.flags.iter() {
diff --git a/lib/src/spec/mount.rs b/lib/src/spec/mount.rs
index 623edd8a..7ea0a748 100644
--- a/lib/src/spec/mount.rs
+++ b/lib/src/spec/mount.rs
@@ -1,11 +1,11 @@
 use std::fmt::Display;
 
-use kdl::{KdlEntry, KdlNode};
+use kdl::KdlNode;
 use serde::Serialize;
 
 use crate::error::Result;
 use crate::spec::context::ParsingContext;
-use crate::spec::helpers::NodeHelper;
+use crate::spec::helpers::{string_entry, NodeHelper};
 
 #[derive(Debug, Default, Clone, Serialize)]
 pub struct SpecMount {
@@ -44,7 +44,7 @@ impl SpecMount {
 impl From<&SpecMount> for KdlNode {
     fn from(mount: &SpecMount) -> KdlNode {
         let mut node = KdlNode::new("mount");
-        node.push(KdlEntry::new_prop("run", mount.run.clone()));
+        node.push(string_entry(Some("run"), &mount.run));
         node
     }
 }
diff --git a/mise.lock b/mise.lock
index 3c8901ed..c1100315 100644
--- a/mise.lock
+++ b/mise.lock
@@ -1,4 +1,4 @@
-# @generated - this file is auto-generated by `mise lock` https://mise.jdx.dev/dev-tools/mise-lock.html
+# @generated - this file is auto-generated by `mise lock` https://mise.en.dev/dev-tools/mise-lock.html
 
 [[tools.actionlint]]
 version = "1.7.10"