diff --git a/.markdownlint-cli2.yaml b/.markdownlint-cli2.yaml
index 2fd1409d8..88c67e576 100644
--- a/.markdownlint-cli2.yaml
+++ b/.markdownlint-cli2.yaml
@@ -8,6 +8,11 @@ config:
   # ignore dollar signs
   commands-show-output: false
   no-trailing-punctuation: false
+  no-duplicate-heading:
+    siblings_only: true
+  # allow some tags we use for formatting
+  no-inline-html:
+    allowed_elements: [ "details", "summary" ]
 
 # Include a custom rule package
 #customRules:
diff --git a/documentation/builders/installation.md b/documentation/builders/installation.md
index e12514350..2228ee47f 100644
--- a/documentation/builders/installation.md
+++ b/documentation/builders/installation.md
@@ -29,7 +29,6 @@ Before you can install the Phoniebox software, you need to prepare your Raspberr
 
 ### Pre-boot preparation
 
-<!-- markdownlint-disable MD033 -->
 <details>
 
 <summary>In case you forgot to customize the OS settings, follow these instructions after RPi OS has been written to the SD card.</summary>
@@ -119,7 +118,6 @@ Up to Bullseye, the `config.txt` file is located at `/boot/`. Since Bookworm, th
 
 Reboot before you proceed.
 </details>
-<!-- markdownlint-restore -->
 
 ## Install Phoniebox software
 
diff --git a/documentation/developers/webapp.md b/documentation/developers/webapp.md
index 0406566fa..30b791816 100644
--- a/documentation/developers/webapp.md
+++ b/documentation/developers/webapp.md
@@ -43,8 +43,6 @@ sudo systemctl restart nginx.service
 
 ## Known Issues while building
 
-<!-- markdownlint-disable MD024 -->
-
 ### JavaScript heap out of memory
 
 While (re-) building the Web App, you get the following output:
@@ -151,4 +149,3 @@ Remove the mode packages and rerun again the script.
 ``` {.bash emphasize-lines="8,9"}
 rm -rf node_modules
 ```
-<!-- markdownlint-restore -->