This article offers a sample of basic Markdown syntax that can be used in Hugo content files.

Basic Syntax

Headings

1
2
3
4
5
6
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6

Heading 2

Heading 3

Heading 4

Heading 5
Heading 6

Emphasis

1
2
3
4
5
6
7
*This text will be italic*
_This will also be italic_

**This text will be bold**
__This will also be bold__

_You **can** combine them_

This text will be italic

This will also be italic

This text will be bold

This will also be bold

You can combine them

Lists

Unordered

1
2
3
4
* Item 1
* Item 2
  * Item 2a
  * Item 2b
  • Item 1
  • Item 2
    • Item 2a
    • Item 2b

Ordered

1
2
3
4
5
1. Item 1
2. Item 2
3. Item 3
   1. Item 3a
   2. Item 3b

Images

1
![GitHub Logo](https://github.githubassets.com/images/modules/logos_page/GitHub-Mark.png)

GitHub Logo

1
[Hugo](https://gohugo.io)

Hugo

Blockquotes

1
2
3
As Newton said:

> If I have seen further it is by standing on the shoulders of Giants.

If I have seen further it is by standing on the shoulders of Giants.

Inline Code

1
Inline `code` has `back-ticks around` it.

Inline code has back-ticks around it.

Code Blocks

Syntax Highlighting

1
2
3
4
5
```go
func main() {
    fmt.Println("Hello World")
}
```
1
2
3
func main() {
    fmt.Println("Hello World")
}

Tables

1
2
3
4
| Syntax    | Description |
| --------- | ----------- |
| Header    | Title       |
| Paragraph | Text        |
SyntaxDescription
HeaderTitle
ParagraphText

References