.markdownlint.yaml

# Markdownlint configuration for EsoCore project (single source of truth; do not add .markdownlint.jsonc)
default: true

# Allow HTML in specific files that need it for rendering
MD033:
  allowed_elements:
    - div    # Needed for BOM rendering
    - br     # Occasional line breaks
    - sup    # Superscripts
    - sub    # Subscripts

# Line length requirement per project standards
MD013:
  line_length: 150
  code_blocks: false
  tables: false
  headings: false

# Allow multiple top-level headings in files that need them (like changelogs, multi-section docs)
MD025: false

# Allow emphasis as heading in specific contexts
MD036: false

# Allow bare URLs in technical documentation  
MD034: false

# Allow trailing punctuation in headings for specific cases
MD026:
  punctuation: ".,;:"  # Exclude colon to allow "BOM:" style headings