Markdown Formatter / Linter

Format and lint Markdown documents. Fix inconsistent headings, list markers, trailing whitespace, and missing blank lines.

Frequently Asked Questions

What does the Markdown Linter check?

It checks for inconsistent heading levels, missing blank lines around headings and lists, trailing whitespace, inconsistent list markers, headings without a space after #, and excessive blank lines.

Does it modify my content?

The formatter applies automatic fixes (adds blank lines, normalizes list markers, trims trailing whitespace) and shows you exactly what was changed.

What list marker does it normalize to?

By default, unordered list markers are normalized to dashes (-). The formatter also preserves ordered list numbering.

How does heading level checking work?

It ensures heading levels only increase by one (e.g. # → ## is fine, # → ### skips a level). Skipped levels are flagged and reported.

Can I use this for GitHub Flavored Markdown?

Yes — the formatter handles standard Markdown and GFM features like task lists, fenced code blocks, and tables.