Hugo Markdown Cheatsheet

Every section below shows rendered output (if applicable) and a copyable example block showing exactly how to write it.

Headings

Rendered

H1 — Big Title

H2 — Section

H3 — Subsection

H4

H5

H6

Copyable

# H1 — Big Title
## H2 — Section
### H3 — Subsection
#### H4
##### H5
###### H6

Emphasis

Rendered

Italic Bold Bold Italic Strikethrough Inline code

Copyable

*Italic*  
**Bold**  
***Bold Italic***  
~~Strikethrough~~  
`Inline code`

Paragraphs & Line Breaks

Rendered

A blank line makes a new paragraph. Add two spaces at line end for a manual line break. Like this.

Copyable

A blank line makes a new paragraph.
Add two spaces at line end for a manual line break.  
Like this.

Blockquotes

Rendered

Single paragraph quote

Multiple paragraphs are okay.

Nested:

Deeper quote

Copyable

> Single paragraph quote
>
> Multiple paragraphs are okay.

> Nested:
>> Deeper quote

Lists

Rendered

Unordered

• One

• Two

  • Two A
  • Two B

• Three

Ordered

1. First

2. Second

   1. Second A
   2. Second B

3. Third

Task Lists

Copyable

- One
- Two
  - Two A
  - Two B
- Three

1. First
2. Second
   1. Second A
   2. Second B
3. Third

- [x] Done
- [ ] To do

Links

Rendered

Inline link

Inline with title

Reference style:

Copyable

[Inline link](https://example.com)

[Inline with title](https://example.com "Title text")

Reference style: [Example][ex]

[ex]: https://example.com "Optional title"

Images

Rendered

Copyable

![Alt text for accessibility](/path/to/image.jpg "Optional title")

Code

Rendered

console.log("Hello world!")

Copyable

```js
console.log("Hello world!")

Tables

Rendered

Copyable

| Feature | Works | Notes |
|---|---|---|
| Tables | ✅ | Standard Markdown |
| Footnotes | ✅ | Goldmark |

Footnotes

Rendered

Footnote example.

Copyable

Footnote example.[^a]

[^a]: This is the first footnote.

Horizontal Rule

Rendered

Copyable

---

Shortcodes — Embeds

YouTube

Vimeo

Gist

Tweet

Academics are one of the biggest groups using the #TwitterAPI to research what’s happening. Their work helps make the world (& Twitter) a better place, and now more than ever, we must enable more of it. 
Introducing 🥁 the Academic Research product track!https://t.co/nOFiGewAV2
— Developers (@XDevelopers) January 26, 2021

Instagram

Image with caption:

Task list:

- [ ] Item 1
- [ ] Item 2