Markdown Cheat Sheet

This blog content is taken from mattcone/markdown-guide. Several extended markdown spec are unsupported by default by Zola which are marked with "X" below.


Thanks for visiting The Markdown Guide!

This Markdown cheat sheet provides a quick overview of all the Markdown syntax elements. It can’t cover every edge case, so if you need more information about any of these elements, refer to the reference guides for basic syntax and extended syntax.

Basic Syntax

These are the elements outlined in John Gruber’s original design document. All Markdown applications support these elements.

Heading

H1

H2

H3

Bold

bold text

Italic

italicized text

Blockquote

blockquote

Ordered List

  1. First item
  2. Second item
  3. Third item

Unordered List

Code

code

Horizontal Rule


Markdown Guide

Image

alt text

Extended Syntax

These elements extend the basic syntax by adding additional features. Not all Markdown applications support these elements.

Table

SyntaxDescription
HeaderTitle
ParagraphText

Fenced Code Block

{
  "firstName": "John",
  "lastName": "Smith",
  "age": 25
}

Footnote

Here's a sentence with a footnote. 1

1

This is the footnote.

Heading ID

My Great Heading

Definition List (X)

term : definition

Strikethrough

The world is flat.

Task List

Emoji (X)

That is so funny! :joy:

(See also Copying and Pasting Emoji)

Highlight (X)

I need to highlight these ==very important words==.

Subscript (X)

H~2~O

Superscript (X)

X^2^