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: - - +