diff --git a/.markdownlint.yaml b/.markdownlint.yaml
index 03841fb0b69..61e39a0a22f 100644
--- a/.markdownlint.yaml
+++ b/.markdownlint.yaml
@@ -1,22 +1,14 @@
+# See https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md
+# and https://github.com/DavidAnson/markdownlint/blob/main/README.md
+
 # Default state for all rules
 default: true
 
-# ul-style
-MD004: false
-
-# line-length
-MD013: false
-
-# no-duplicate-header
-MD024:
+ul-style: false
+line-length: false
+no-duplicate-header:
   siblings_only: true
-
-# ol-prefix
-MD029:
+ol-prefix:
   style: ordered
-
-# no-inline-html
-MD033: false
-
-# fenced-code-language
-MD040: false
+no-inline-html: false
+fenced-code-language: false