diff --git a/doc/user/group/saml_sso/scim_setup.md b/doc/user/group/saml_sso/scim_setup.md
index 0f07d8946bea97f682bd9af10591bf4091530391..f737e31a3d51724f545ee3149b47815f431c6ed5 100644
--- a/doc/user/group/saml_sso/scim_setup.md
+++ b/doc/user/group/saml_sso/scim_setup.md
@@ -144,18 +144,20 @@ The following table provides attribute mappings that are required for GitLab.
| Source attribute | Target attribute | Matching precedence |
|:---------------------------------------------------------------------------|:-------------------------------|:--------------------|
| `objectId` | `externalId` | 1 |
-| `userPrincipalName` OR `mail` (1) | `emails[type eq "work"].value` | |
+| `userPrincipalName` OR `mail` <sup>1</sup> | `emails[type eq "work"].value` | |
| `mailNickname` | `userName` | |
-| `displayName` OR `Join(" ", [givenName], [surname])` (2) | `name.formatted` | |
-| `Switch([IsSoftDeleted], , "False", "True", "True", "False")` (3) | `active` | |
-
-<!-- markdownlint-disable MD029 -->
-
-1. Use `mail` as a source attribute when the `userPrincipalName` is not an email address or is not deliverable.
-2. Use the `Join` expression if your `displayName` does not match the format of `Firstname Lastname`.
-3. This is an expression mapping type, not a direct mapping. Select "Expression" in the "Mapping type" dropdown list.
-
-<!-- markdownlint-enable MD029 -->
+| `displayName` OR `Join(" ", [givenName], [surname])` <sup>2</sup> | `name.formatted` | |
+| `Switch([IsSoftDeleted], , "False", "True", "True", "False")` <sup>3</sup> | `active` | |
+
+<html>
+<small>
+ <ol>
+ <li>Use <code>mail</code> as a source attribute when the <code>userPrincipalName</code> is not an email address or is not deliverable.</li>
+ <li>Use the <code>Join</code> expression if your <code>displayName</code> does not match the format of <code>Firstname Lastname</code>.</li>
+ <li>This is an expression mapping type, not a direct mapping. Select <b>Expression</b> in the <b>Mapping type</b> dropdown list.</li>
+ </ol>
+</small>
+</html>
Each attribute mapping has: