Markdown Linter and Formatter

Clean up a Markdown file's formatting with an online linter

Markdown looks simple until three people edit the same file. One uses asterisks for bullets, another dashes, headings skip a level, and a stray tab sneaks into a paragraph. The Markdown Linter and Formatter tidies that, so a readme or a docs page reads the same way no matter who last touched it.

Upload a .md or .markdown file and the tool rewrites it to a consistent style. It strips trailing spaces and hard tabs, adds a space after a heading's hash marks, removes closing hash marks some editors leave behind, and normalizes every bullet to one marker. It inserts blank lines around headings, lists and fenced code blocks where they were missing, wraps bare web addresses in angle brackets, aligns pipe table columns, and adds a final newline if one is missing. Fenced code itself is never touched, so snippets keep their formatting.

A short report is appended as a comment at the end of the file, listing each fix and each flagged issue by line number, such as a skipped heading level, a missing top-level heading, an unlabeled code fence, or a duplicate heading.

There are no settings to configure; you upload and download. Your file goes to our servers for the check and is removed within the hour. To check whether links in that document work, try the Markdown Link Checker next.