MD023 - Headers must start at the beginning of the line

Tags: headers, spaces

Aliases: header-start-left

This rule is triggered when a header is indented by one or more spaces:

Some text

  # Indented header

To fix this, ensure that all headers start at the beginning of the line:

Some text

# Header

Rationale: Headers that don't start at the beginning of the line will not be parsed as headers, and will instead appear as regular text.

MD023 - Headers must start at the beginning of the line

Tags: headers, spaces

Aliases: header-start-left

This rule is triggered when a header is indented by one or more spaces:

Some text

  # Indented header

To fix this, ensure that all headers start at the beginning of the line:

Some text

# Header

Rationale: Headers that don't start at the beginning of the line will not be parsed as headers, and will instead appear as regular text.

MD002 - First header should be a top level header

Tags: headers

Aliases: first-header-h1

Parameters: level (number; default 1)

This rule is triggered when the first header in the document isn't a h1 header:

## This isn't a H1 header

### Another header

The first header in the document should be a h1 header:

# Start with a H1 header

## Then use a H2 for subsections