MDS013-blank-line-around-headings

id	MDS013
name	blank-line-around-headings
status	ready
description	Headings must have a blank line before and after.
category	heading
nature	style
maintainability
markdownlint	id name partial default MD022 blanks-around-headings false true
rumdl	id name partial default MD022 blanks-around-headings false true
mado	id name partial default MD022 blanks-around-headings false true
panache
obsidian-linter	id name partial default heading-blank-lines heading-blank-lines false false
gomarklint	id name partial default blanks-around-headings blanks-around-headings false true

MDS013: blank-line-around-headings

Headings must have a blank line before and after.

Config

Enable:

rules:
  blank-line-around-headings: true

Disable:

rules:
  blank-line-around-headings: false

Examples

Bad

# Title
## Section

Content here.

Good

# Title

## Section

Content here.

Diagnostics

Message	Condition
heading should have a blank line before	Previous line is not blank
heading should have a blank line after	Next line after heading is not blank

Meta-Information

• ID: MDS013
• Name: blank-line-around-headings
• Status: ready
• Default: enabled
• Fixable: yes
• Implementation: source
• Category: heading
• markdownlint: MD022 (blanks-around-headings)
• rumdl: MD022 (blanks-around-headings)
• mado: MD022 (blanks-around-headings)
• obsidian-linter: heading-blank-lines
• gomarklint: blanks-around-headings