markdownlint-configuration

# Markdownlint Configuration

Master markdownlint configuration including rule management, configuration files, inline comment directives, style inheritance, and schema validation for consistent Markdown linting.

## Overview

Markdownlint is a Node.js style checker and linter for Markdown/CommonMark files. It helps enforce consistent formatting and style across Markdown documentation by providing a comprehensive set of rules that can be customized through configuration files or inline comments.

## Installation and Setup

### Basic Installation

Install markdownlint in your project:

```bash
npm install --save-dev markdownlint markdownlint-cli
# or
pnpm add -D markdownlint markdownlint-cli
# or
yarn add -D markdownlint markdownlint-cli
```

### Verify Installation

```bash
npx markdownlint --version
```

## Configuration File Structure

### Basic .markdownlint.json

Create a `.markdownlint.json` file in your project root:

```json
{
  "default": true,
  "MD003": { "style": "atx_closed" },
  "MD007": { "indent": 4 },
  "no-hard-tabs": false,
  "whitespace": false
}
```

This configuration:
- Enables all default rules via `"default": true`
- Configures MD003 (heading style) to use ATX closed format
- Sets MD007 (unordered list indentation) to 4 spaces
- Disables the no-hard-tabs rule
- Disables all whitespace rules

### Rule Naming Conventions

Rules can be referenced by their ID (MD###) or friendly name:

```json
{
  "MD001": false,
  "heading-increment": false,
  "MD003": { "style": "atx" },
  "heading-style": { "style": "atx" },
  "no-inline-html": {
    "allowed_elements": ["strong", "em", "br"]
  }
}
```

Both ID and friendly name work identically.

## Configuration Options

### Enable/Disable All Rules

```json
{
  "default": true
}
```

When `"default": false`, only explicitly enabled rules are active:

```json
{
  "default": false,
  "MD001": true,
  "MD003": { "style": "atx" },
  "line-length": true
}
```

### Rule-Specific Parameters

#### Heading Style (MD