Validating Configuration

A JSON Schema is provided to enable validating configuration objects: markdownlint-config-schema.json.

Some editors automatically use a JSON Schema with files that reference it. For example, a .markdownlint.json file with:

"$schema": "https://raw.githubusercontent.com/DavidAnson/markdownlint/main/schema/markdownlint-config-schema.json"

A JSON Schema validator can be used to check configuration files like so:

npx ajv-cli validate -s ./markdownlint/schema/markdownlint-config-schema.json -d "**/.markdownlint.{json,yaml}" --strict=false

By default, any rule name is valid because of custom rules. To allow only built-in rules, use the markdownlint-config-schema-strict.json JSON Schema instead.