diff --git a/nixos/modules/misc/documentation.nix b/nixos/modules/misc/documentation.nix
index 462575f17e81..516bf903187b 100644
--- a/nixos/modules/misc/documentation.nix
+++ b/nixos/modules/misc/documentation.nix
@@ -282,8 +282,11 @@ in
         default = false;
         description = ''
           Whether to generate the manual page index caches at runtime using
-          a systemd service. Note that this is currently only supported by the
-          man-db module.
+          a systemd service.
+
+          ::: {.note}
+          This is currently only supported by the man-db module.
+          :::
         '';
       };