Introduction

Markdown is a lightweight markup language with plain text formatting syntax. It is designed so that it can be converted to HTML and many other formats using a tool by the same name. Markdown is often used to format readme files, for writing messages in online discussion forums, and to create rich text using a plain text editor.

Zola support CommonMark as the markdown parser. Further, it optionally supports parsing footnotes, Github flavored tables and task lists, and strikethrough text.

Syntax

Headers

Header 4

Header 5

Header 6

# Header 1

## Header 2

### Header 3

#### Header 4

##### Header 5

###### Header 6

Paragraphs

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.

This is a new paragraph.

And this is another paragraph. This is still part of the same paragraph.

This is a new paragraph.

And this is another paragraph.
This is still part of the same paragraph.

Text Formatting

Bold Text Italic Text
Strikethrough Text
Bold and Italic Text

**Bold Text**
_Italic Text_
~~Strikethrough Text~~
**_Bold and Italic Text_**

Lists

Unordered List

• Item 1
• Item 2
  • Subitem 2.1
  • Subitem 2.2

- Item 1
- Item 2
  - Subitem 2.1
  - Subitem 2.2

Ordered List

1. First item
2. Second item
   1. Subitem 2.1
   2. Subitem 2.2

1. First item
2. Second item
   1. Subitem 2.1
   2. Subitem 2.2

Links and Images

Link to github

[Link to github](https://github.com/exiguus/zola-monoplain)

![Github Profile Image](https://avatars.githubusercontent.com/u/1060633)

Blockquotes

This is a blockquote.

• Blockquote can have lists.
• It can also have bold or italic text.

> This is a blockquote.
>
> - Blockquote can have lists.
> - It can also have **bold** or _italic_ text.

Code

Inline Code

This is inline code example.

This is `inline code` example.

Code Blocks

def hello_world():
    print("Hello, World!")

hello_world()

```python
def hello_world():
    print("Hello, World!")

hello_world()
```

Tables

| Name    | Age | Gender |
| ------- | --- | ------ |
| Alice   | 25  | Female |
| Bob     | 30  | Male   |
| Charlie | 22  | Male   |

Task Lists

• Task 1
• Task 2
• Task 3

- [x] Task 1
- [ ] Task 2
- [ ] Task 3

Horizontal Rule

---

Emojis

😃 🚀 💸

:smiley: :rocket: :money_with_wings:

Escaping Characters

To escape characters like * or _, use backslashes: *escaped* and _escaped_

To escape characters like \* or \_, use backslashes: \*escaped\* and \_escaped\_

HTML

Definition list

Is something people use sometimes.

Markdown in HTML

Does *not* work **very** well. Use HTML tags.

<dl>
  <dt>Definition list</dt>
  <dd>Is something people use sometimes.</dd>

  <dt>Markdown in HTML</dt>
  <dd>Does *not* work **very** well. Use HTML <em>tags</em>.</dd>
</dl>

Footnotes

Here is a footnote reference,¹ and another.²

Subsequent paragraphs are indented to show that they belong to the previous footnote.

Here is a footnote reference,[^1] and another.[^2]

[^1]: Here is the footnote.
[^2]: Here's one with multiple blocks.

Subsequent paragraphs are indented to show that they belong to the previous footnote.

References

Zola³ use pulldown-cmark⁴ as pull parser for CommonMark⁵ as the markdown parser. Further, it optionally supports parsing footnotes, Github flavored tables⁶, Github flavored task lists⁷ and strikethrough⁸ text.