Skip to content

Instantly share code, notes, and snippets.

What would you like to do?
A few common Markdown mistakes

The following snippets show some common Markdown mistakes.

Click the Raw button to see the source text and understand the author's intent.

GitHub's parser handles some of these cases; other parsers do not.

To catch these problems automatically:


foolish consistency

is the



little minds

Ralph Waldo Emerson

A popular HTML tag is the


  • This is a list
  • followed by text But there is no blank line

A haiku of code

Without blank lines around it

(GitHub gets it right)

// Comment and "var" highlighting is only for JavaScript
var i = 5;
// Much better here
var j = 5;
  1. Numbering
  2. is
  3. hard.
  4. Let's go shopping.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment