Improve markdown & fix links

modules/saml/docs/nameidattribute.md

@@ -14,15 +14,14 @@ Parameters
 :   The format string for the attribute.
     The default is `%I!%S!%V`.
 
-:   The format string accepts the following replacements:
-
-    * `%I`: The IdP that issued the NameID.
-            This will be the `NameQualifier` element of the NameID if it is present, or the entity ID of the IdP we received the response from if not.
-    * `%S`: The SP the NameID was issued to.
-            This will be the `SPNameQualifier` element of the NameID if it is present, or the entity ID of this SP otherwise.
-    * `%V`: The value of the NameID.
-    * `%F`: The format of the NameID.
-    * `%%`: Will be replaced with a single `%`.
+The format string accepts the following replacements:
+* `%I`: The IdP that issued the NameID.
+   This will be the `NameQualifier` element of the NameID if it is present, or the entity ID of the IdP we received the response from if not.
+* `%S`: The SP the NameID was issued to.
+  This will be the `SPNameQualifier` element of the NameID if it is present, or the entity ID of this SP otherwise.
+* `%V`: The value of the NameID.
+* `%F`: The format of the NameID.
+* `%%`: Will be replaced with a single `%`.
 
 Examples
 --------
@@ -63,5 +62,5 @@ Only extract the value of the NameID.
 See also
 --------
 
-* [The description of the `saml:SP` authentication source.](./saml:sp)
-* [How to generate various NameIDs on the IdP.](./saml:nameid)
+* [The description of the `saml:SP` authentication source.](../saml:sp)
+* [How to generate various NameIDs on the IdP.](../saml:nameid)