.markdownlint-cli2.jsonc

{
  // Safeword markdownlint configuration
  // Philosophy: Only enforce rules that affect rendering or LLM comprehension
  // Cosmetic/stylistic rules disabled - LLMs don't care about line length or bullet style
  "config": {
    "default": false,

    // RENDERING-CRITICAL (broken markdown if violated)
    "MD011": true, // Reversed link syntax [text](url) not (text)[url]
    "MD018": true, // Space required after # in headings
    "MD037": true, // No spaces inside emphasis markers **like this**
    "MD038": true, // No spaces inside code spans `like this`
    "MD042": true, // No empty links [text]()
    "MD056": true, // Table column count must be consistent

    // LLM-IMPORTANT (structure clarity for tokenization)
    "MD001": true, // Heading levels increment by one (h1 -> h2, not h1 -> h3)
    "MD022": true, // Blank lines around headings
    "MD031": true, // Blank lines around fenced code blocks
    "MD032": true, // Blank lines around lists
    "MD058": true, // Blank lines around tables
  },
}