diff --git a/book/src/generated/typable-cmd.md b/book/src/generated/typable-cmd.md
index 426598e3d..17d10c996 100644
--- a/book/src/generated/typable-cmd.md
+++ b/book/src/generated/typable-cmd.md
@@ -55,7 +55,7 @@
 | `:tutor` | Open the tutorial. |
 | `:goto`, `:g` | Go to line number. |
 | `:set-language`, `:lang` | Set the language of current buffer. |
-| `:set-option`, `:set` | Set a config option at runtime. |
+| `:set-option`, `:set` | Set a config option at runtime.<br>For example to disable smart case search, use `:set search.smart-case false`. |
 | `:get-option`, `:get` | Get the current value of a config option. |
 | `:sort` | Sort ranges in selection. |
 | `:rsort` | Sort ranges in selection in reverse order. |
diff --git a/helix-term/src/commands/typed.rs b/helix-term/src/commands/typed.rs
index 68aa7703c..68b64bb8d 100644
--- a/helix-term/src/commands/typed.rs
+++ b/helix-term/src/commands/typed.rs
@@ -1594,7 +1594,7 @@ fn run_shell_command(
         TypableCommand {
             name: "set-option",
             aliases: &["set"],
-            doc: "Set a config option at runtime.",
+            doc: "Set a config option at runtime.\nFor example to disable smart case search, use `:set search.smart-case false`.",
             fun: set_option,
             completer: Some(completers::setting),
         },
diff --git a/xtask/src/main.rs b/xtask/src/main.rs
index ad120f4f1..a4c69d701 100644
--- a/xtask/src/main.rs
+++ b/xtask/src/main.rs
@@ -106,7 +106,9 @@ pub fn typable_commands() -> Result<String, DynError> {
                 .collect::<Vec<_>>()
                 .join(", ");
 
-            md.push_str(&md_table_row(&[names.to_owned(), cmd.doc.to_owned()]));
+            let doc = cmd.doc.replace("\n", "<br>");
+
+            md.push_str(&md_table_row(&[names.to_owned(), doc.to_owned()]));
         }
 
         Ok(md)