Markdown Guide

Blog posts in Ghost are written using Markdown. Markdown is a minimal syntax for marking up your documents with formatting, using punctuation and special characters. For those new to Markdown, this guide will help you become familiar with the full list of shortcuts and a few of our own additions. Ghost’s version of markdown is a combination of standard Markdown, GitHub Flavored Markdown, and other useful features like footnotes.

Note: All HTML is valid Markdown. If you’re stuck not able to format your content how you would like (for example using tables) you can always use plain HTML instead of Markdown.
Markdown Help

The most common formatting options have keyboard shortcuts to make them easier to add:

Result Markdown Shortcut
Bold text Ctrl/⌘ + B
Emphasize text Ctrl/⌘ + I
Strike-through text Ctrl + Alt + U
Link title Ctrl/⌘ + K
Inline Code code Ctrl/⌘ + Shift + K
Image alt Ctrl/⌘ + Shift + I
List * item Ctrl + L
Blockquote > quote Ctrl + Q
H1 # Heading
H2 ## Heading Ctrl/⌘ + H
H3 ### Heading Ctrl/⌘ + H (x2)

Headers are set using a hash before the title. The number of hashes before the title text will determine the depth of the header. Header depths are from 1-6

H1 : # Header 1
H2 : ## Header 2
H3 : ### Header 3
H4 : #### Header 4
H5 : ##### Header 5
H6 : ###### Header 6
Text Styling

Links : Title
Bold : Bold
Italicize : Italics
Strike-through : text
Highlight : text
Paragraphs : Line space between paragraphs
Line break : Add two spaces to the end of the line
Lists : * an asterisk for every new list item.
Quotes : > Quote
Inline Code : alert('Hello World');
Horizontal Rule (HR) : --------

To insert an image into your post, you need to first type into the Markdown editor panel. This will create an image upload box in your preview panel.

add image box

You can drag and drop images (.png, .gif, .jpg) from your Desktop over the image upload box to include it into your post, or alternatively click the image upload box to use a standard image upload popup. If you prefer to include an image url, click the “link” icon in the bottom left corner of the image upload box, this will then present you with the ability to insert an image URL.

image url

Adding Alt Text
To add alt text to your image, all you need to do is place the text in-between the square brackets, e.g;This is a alt text.

Hyperlinking Images
To hyperlink your image, wrap the image markdown in the markdown for creating a link. E.g. Image Alt Text

Be sure read How to Add an Image to Your Post for a full instruction on image handling with your Ghost blog.


Footnotes can be added to the body of your text using placeholders like this: [1]. For example,

This is text with a footnote link at the end. [1:1]
Alternatively you can use ‘n’ rather than numbers [2] so you don’t have to worry about which number you are on. At the very end of your post, you can define your matching footnotes as shown below, URLs will be turned into links:

Inline code can be added using single back-ticks E.g. alert('Hello World').

For code blocks, Ghost supports both standard markdown code blocks and the syntax from GitHub Flavored Markdown (GFM). Standard markdown works by indenting code lines with 4 spaces:


GFM uses triple back-ticks ```



Link Markdown Example

This is a paragraph that contains a link to ghost.
List Markdown Example

This paragraph contains a list of items.

  • Item 1
  • Item 2
  • Item three
    Quote Markdown Example

This paragraph has a quote

That is pulled out like this

from the text my post.

  1. This is my first footnote ↩︎ ↩︎

  2. A final footnote
    Writing Code ↩︎