mono/plain; a11y=true

An accessible, monospace plain Zola Theme

By Simon Gattner

Markdown

Created: 2024-03-26

Updated: 2025-06-07

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

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

Link to github

Github Profile Image

[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

NameAgeGender
Alice25Female
Bob30Male
Charlie22Male
| Name    | Age | Gender |
| ------- | --- | ------ |
| Alice   | 25  | Female |
| Bob     | 30  | Male   |
| Charlie | 22  | Male   |

Task Lists

- [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

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.

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.

<​​​​markdown.monoplain​​​@0x38​.​​de​​​>

Tags