ci: update markdownlint config

Author: chrisgrieser

.markdownlint.yaml

@@ -1,24 +1,18 @@
-# Defaults https://github.com/DavidAnson/markdownlint/blob/main/schema/.markdownlint.yaml
 # DOCS https://github.com/markdownlint/markdownlint/blob/main/docs/RULES.md
-#───────────────────────────────────────────────────────────────────────────────
+#-------------------------------------------------------------------------------
 
-# MODIFIED SETTINGS
-blanks-around-headings:
-  lines_below: 0 # space waster
-ul-style: { style: sublist }
+default: warning
 
-# not autofixable
+#-MODIFIED SETTINGS-------------------------------------------------------------
+blanks-around-headings: { lines_below: 0 } # rule of proximity
+ul-style: { style: sublist }
 ol-prefix: { style: ordered }
-line-length:
-  tables: false
-  code_blocks: false
-no-inline-html:
-  allowed_elements: [img, details, summary, kbd, a, br]
+line-length: { tables: false, code_block_line_length: 90 }
+no-inline-html: { allowed_elements: [img, details, summary, kbd, a, table, tr, td] }
 
-#─────────────────────────────────────────────────────────────────────────────
-# DISABLED
+#-DISABLED----------------------------------------------------------------------
 ul-indent: false # not compatible with using tabs
-no-hard-tabs: false # taken care of by editorconfig
+no-hard-tabs: false # taken care of by .editorconfig
 blanks-around-lists: false # space waster
-first-line-heading: false # e.g., ignore-comments
-no-emphasis-as-heading: false # sometimes useful
+first-line-heading: false # ignore-comments for linters can be in the first line
+no-emphasis-as-heading: false # for small sections that shouldn't be linked in the ToC