diff --git a/nixos/lib/make-options-doc/mergeJSON.py b/nixos/lib/make-options-doc/mergeJSON.py
index cdbf7cc21f0d..ef9f321e1141 100644
--- a/nixos/lib/make-options-doc/mergeJSON.py
+++ b/nixos/lib/make-options-doc/mergeJSON.py
@@ -220,8 +220,11 @@ def convertMD(options: Dict[str, Any]) -> str:
# inline literals need a space to separate ticks from content, code blocks
# need newlines. inline literals need one extra tick, code blocks need three.
ticks, sep = ('`' * (longest + (3 if multiline else 1)), '\n' if multiline else ' ')
- docbook = convertString(name, f"*{key.capitalize()}:*\n{ticks}{sep}{code}{sep}{ticks}")
- option[rendered] = f"{docbook}"
+ docbook = convertString(name, f"{ticks}{sep}{code}{sep}{ticks}")
+ if multiline:
+ option[rendered] = f"{key.capitalize()}: {docbook}"
+ else:
+ option[rendered] = f"{key.capitalize()}: {docbook}"
elif optionIs(option, key, 'literalDocBook'):
option[rendered] = f"{key.capitalize()}: {option[key]['text']}"
elif key in option:
diff --git a/nixos/lib/make-options-doc/options-to-docbook.xsl b/nixos/lib/make-options-doc/options-to-docbook.xsl
index 7a80931df0de..a74429596b85 100644
--- a/nixos/lib/make-options-doc/options-to-docbook.xsl
+++ b/nixos/lib/make-options-doc/options-to-docbook.xsl
@@ -85,10 +85,9 @@
Related packages:
-
-
+