diff --git a/nixos/modules/services/matrix/matrix-authentication-service.nix b/nixos/modules/services/matrix/matrix-authentication-service.nix
index 978f2d571fde..18648d2e3451 100644
--- a/nixos/modules/services/matrix/matrix-authentication-service.nix
+++ b/nixos/modules/services/matrix/matrix-authentication-service.nix
@@ -379,13 +379,16 @@ in
       type = lib.types.attrsOf lib.types.str;
       default = { };
       description = ''
-        Name -> source file path. Exposed to the unit via LoadCredential and
-        readable inside the service at ''${CREDENTIALS_DIRECTORY}/<name>.
+        Mapping of credential name to  source file-path. Exposed to the unit via LoadCredential and
+        readable inside the service at `''${CREDENTIALS_DIRECTORY}/<name>`.
 
-        For example :
+        For example:
+
+        ```
         services.matrix-authentication-service.credentials."synapse-secret" = "/run/agenix/synapse-shared";
         services.matrix-authentication-service.settings.matrix.secret_file =
           "\''${CREDENTIALS_DIRECTORY}/synapse-secret";
+        ```
       '';
     };
   };