Customize markdownlint (#2310)

* Customize markdownlint

* Remove ignore in file

* Remove ignore in file

Author: s-martin

.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:

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
 

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 -->