.markdownlint.yaml

# Default state for all rules
default: true

# MD001/heading-increment - Do not require h1 -> h2 transitions,
# allow headings with better proportions.
# h2 is too large, h3 is just right so we use h1 -> h3 in places.
MD001: false

# MD013/line-length - Allow long lines
MD013: false

# MD033 - Inline HTML. Needed for tabs in docusaurus
MD033: false

# MD041 - Display Caution block before a top-level heading
MD041: false

MD024:
  siblings_only: true
  allow_different_nesting: true

# MD025 - Allow multiple top-level headings in the same document for typedoc generated index
MD025: false