Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

MD006 - List Start Left

Consider starting bulleted lists at the beginning of the line.

Why This Rule Exists

Lists that don't start at the beginning of the line can cause unexpected rendering behavior in some Markdown parsers. Starting lists at column 0 ensures consistent rendering across all platforms.

Examples

Incorrect

Some text:
  - Indented list item
  - Another indented item

Correct

Some text:

- List item at start of line
- Another item at start of line

Nested Lists (Allowed)

- Top level item
  - Nested item (indentation is fine for nesting)
  - Another nested item

Configuration

This rule has no configuration options.

When to Disable

  • Documents with intentionally indented lists for specific formatting
  • Content that uses indentation for semantic meaning

Rule Details

  • Rule ID: MD006
  • Aliases: ul-start-left
  • Category: Formatting
  • Severity: Warning
  • Auto-fix: Yes
  • MD004 - Unordered list style
  • MD005 - List item indentation consistency
  • MD007 - Unordered list indentation
  • MD023 - Headings start at beginning of line