Skip to content

How to format posts on Lemmy using Markdown

Lemmy uses markdown-it for rendering markdown. This means that you can use the same markdown syntax that you would use on Lemmy and it follows the CommonMark spec. Here are some examples of markdown that you can use on Lemmy:

Headers

markdown
# Header 1
## Header 2
### Header 3
#### Header 4
##### Header 5
###### Header 6

Result:

Markdown HeadersMarkdown Headers

Emphasis

markdown
*italic*  
**bold**  
***bold italic***  
~~strikethrough~~

Result:

Markdown EmphasisMarkdown Emphasis

Lists

markdown
- Unordered list item 1
- Unordered list item 2
  - Unordered list item 2.1
  - Unordered list item 2.2
- Unordered list item 3

1. Ordered list item 1
2. Ordered list item 2
3. Ordered list item 3

Result:

Markdown EmphasisMarkdown Emphasis
markdown
[Link text](https://example.com)  
![Image Alt](https://example.com/image.jpg "Image title")  
![The fedecan Logo](https://fedecan.ca/img/icons/maple-leaf.svg "Maple Leaf")

Result:

Markdown Links/ImagesMarkdown Links/Images

Blockquotes

markdown
> Block  
> -quote

Result:

Markdown BlockquotesMarkdown Blockquotes

Code

markdown
`inline code`  

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

Result:

Markdown Inline/BlockcodeMarkdown Inline/Blockcode

Tables

Tables are not officially documented.

markdown
| Header 1 | Header 2 | Header 3 |
|----------|----------|----------|
| Row 1    | Row 1    | Row 1    |
| Row 2    | Row 2    | Row 2    |
| Row 3    | Row 3    | Row 3    |

Result:

Markdown TablesMarkdown Tables

Horizontal Rule

markdown
---

Result:

Markdown Horizontal RuleMarkdown Horizontal Rule

Spoilers

Warning: Spoilers are not yet fully implemented on Apps and may not work as expected on them.

markdown
::: spoiler Spoiler Name
Spoiler Content
:::

Result:

Markdown SpoilersMarkdown Spoilers

Note: In the example above, the spoiler is in the open state, by default it is in the closed state.

Sub/Superscript

markdown
H~2~O
H^2^O

Result:

Markdown Sub/SuperscriptMarkdown Sub/Superscript