.markdownlint.yaml

# 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 } # 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] }

#─────────────────────────────────────────────────────────────────────────────
# DISABLED
ul-indent: false # not compatible with using tabs
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