My Markdown Guide

2026-04-13

This post shows each Markdown element and what it looks like on the page.

A

Headings

Type # (pound) symbol with text to format it as a heading. Add # symbols for each heading level (one through six).

Markdown

# H1
## H2
### H3
#### H4
##### H5
###### H6

Output

H1

H2

H3

H4

H5
H6

Bold Text

Type double asterisks before and after text to make it bold.

Markdown

**Bold text**

Output

Bold text


Italics

Type single asterisk before and after text to make it italic.

Markdown

This has *italic* text.

Output

This has italic text.


Blockquote

Type a right arrow before text to make it a blockquote.

Markdown

> Do it right, but do it.

Output

Do it right, but do it.


Ordered List

Type numbers with periods to make an ordered (numbered) list.

Markdown

1. Item 1
2. Item 2
3. Item 3

Output

  1. Item 1
  2. Item 2
  3. Item 3

Unordered List

Type hyphens at the start of each line to make an unordered (bulleted) list.

Markdown

- Item 1
- Item 2
- Item 3

Output


Code

Type backticks before and after text to format it as code.

Markdown

This line contains `code` in it.

Output

This line contains code in it.


Horizontal Rule

Type three hyphens on their own line to format it as a horizontal line. Note: three hyphens right below other text will make it an H1, so there is an extra line between the text above the line and the hyphens.

Markdown

Text above the line

---
Text below the line

Output

Text above the line


Text below the line


Links

Type brackets for the text that will display on the page and parentheses for the link to format it as a link.

Markdown

[Ordered List - My Markdown Guide](/posts/my-markdown-guide#ordered-list)

[colinelleby.com](/)

Output

Ordered List - My Markdown Guide

colinelleby.com


Images

Type an before and after text to format it as code.

Markdown

![A workbench with an assortment of woodworking tools.](/images/tools.jpg)

Output

A workbench with an assortment of woodworking tools.