diff --git a/content/markdown/introduction-to-markdown.md b/content/markdown/introduction-to-markdown.md
index ff8db4f..75f3801 100644
--- a/content/markdown/introduction-to-markdown.md
+++ b/content/markdown/introduction-to-markdown.md
@@ -121,6 +121,7 @@ To add footnotes use the syntax `[^name]` inline, and define them with:
```markdown
Text with a footnote.[^1]
+
[^1]: A footnote.
```
diff --git a/content/markdown/using-links.md b/content/markdown/using-links.md
index 274eb47..85f3e68 100644
--- a/content/markdown/using-links.md
+++ b/content/markdown/using-links.md
@@ -78,17 +78,21 @@ This is rendered as:
The link parser used in Forgejo can also work with the _double square brackets_ syntax in issues and
other places where markdown is rendered:
+
```markdown
[[https://codeberg.org/]]
```
+
will get rendered as .
You can also give a link description, as with the regular markdown syntax:
+
```markdown
[[This is a link to Codeberg|https://codeberg.org]]
```
+
will be rendered as [This is a link to Codeberg](https://codeberg.org).