Markdown
Created:
Updated:
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
- First item
- Second item
- Subitem 2.1
- Subitem 2.2
1. First item
2. Second item
1. Subitem 2.1
2. Subitem 2.2
Links and Images
[Link to github](https://github.com/exiguus/zola-monoplain)

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 |
| 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,1 and another.2
Here is the footnote.
Here's one with multiple blocks.
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
Zola3 use pulldown-cmark4 as pull parser for CommonMark5 as the markdown parser. Further, it optionally supports parsing footnotes, Github flavored tables6, Github flavored task lists7 and strikethrough8 text.
Feedback
Have thoughts or experiences you'd like to share? I'd love to hear from you! Whether you agree, disagree, or have a different perspective, your feedback is always welcome. Drop me an email and let's start a conversation.