diff --git a/.markdownlint.jsonc b/.markdownlint.jsonc
index 230ac13f..27aa4c51 100644
--- a/.markdownlint.jsonc
+++ b/.markdownlint.jsonc
@@ -2,7 +2,10 @@
 
 {
   "default": true,
-  "MD033": false, // Allow inline JSX.
+  "MD007": { // Unordered list indentation
+    "indent": 4 // 4 spaces so MkDocs can render nested lists correctly
+  },
+  "MD033": false, // Allow inline JSX and custom web components
   "MD024": false, // Allow duplicate headings
   "line-length": {
     "code_block_line_length": 120,
diff --git a/src/components/Button/README.md b/src/components/Button/README.md
index a65153bd..778e02e2 100644
--- a/src/components/Button/README.md
+++ b/src/components/Button/README.md
@@ -433,10 +433,10 @@ Where:
 - `<INTERACTION STATE>` is one of `default`, `hover`, `active`, or `disabled`
   (the last one being optional),
 - `<PROPERTY>` is one of:
-  - `color`, `border-color`, `background`, or `box-shadow` for the `filled`
-    priority,
-  - `color`, `border-color`, or `background` for the `outline` priority,
-  - `color` or `background` for the `flat` priority.
+    - `color`, `border-color`, `background`, or `box-shadow` for the `filled`
+      priority,
+    - `color`, `border-color`, or `background` for the `outline` priority,
+    - `color` or `background` for the `flat` priority.
 
 ### Theming Sizes
 
diff --git a/src/components/Card/README.md b/src/components/Card/README.md
index 32da3f8e..204c380d 100644
--- a/src/components/Card/README.md
+++ b/src/components/Card/README.md
@@ -47,8 +47,8 @@ See [API](#api) for all available options.
 Card is decomposed into the following components:
 
 - [Card](#api)
-  - [CardBody](#cardbody)
-  - [CardFooter](#cardfooter)
+    - [CardBody](#cardbody)
+    - [CardFooter](#cardfooter)
 
 Aside from the [CardBody](#cardbody) element, you can add a
 [CardFooter](#cardfooter) to better separate your card's actions from the rest
diff --git a/src/components/Modal/README.md b/src/components/Modal/README.md
index 50e56f9e..e1188826 100644
--- a/src/components/Modal/README.md
+++ b/src/components/Modal/README.md
@@ -105,13 +105,13 @@ See [API](#api) for all available options.
 Modal is decomposed into the following components:
 
 - Modal
-  - [ModalHeader](#modalheader)
-    - ModalTitle
-    - ModalCloseButton
-  - [ModalBody](#modalbody)
-    - ModalContent
-      (may be wrapped with [ScrollView](/components/ScrollView))
-  - [ModalFooter](#modalfooter)
+    - [ModalHeader](#modalheader)
+        - ModalTitle
+        - ModalCloseButton
+    - [ModalBody](#modalbody)
+        - ModalContent
+          (may be wrapped with [ScrollView](/components/ScrollView))
+    - [ModalFooter](#modalfooter)
 
 Using different combinations, you can compose different kinds of modals,
 e.g. dialog modal, blocking modal, scrollable modal, etc.