From 10f7ef959372beb9dc71593463cfd5b19addabbb Mon Sep 17 00:00:00 2001
From: bgg <bgg@noreply.codeberg.org>
Date: Fri, 12 Dec 2025 19:32:28 +0100
Subject: [PATCH] Add how to add footnotes in a markdown file. (#718)

It could be useful to have this information in the documentation.

Co-authored-by: bgg <bgg@bombe>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/718
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
Co-authored-by: bgg <bgg@noreply.codeberg.org>
Co-committed-by: bgg <bgg@noreply.codeberg.org>
---
 content/images/markdown/Footnote-example.png | Bin 0 -> 2211 bytes
 content/markdown/introduction-to-markdown.md |  35 ++++++++++++++++---
 2 files changed, 31 insertions(+), 4 deletions(-)
 create mode 100644 content/images/markdown/Footnote-example.png

diff --git a/content/images/markdown/Footnote-example.png b/content/images/markdown/Footnote-example.png
new file mode 100644
index 0000000000000000000000000000000000000000..c5b8d8a9ef480878e903e62a8dd23be600c5003d
GIT binary patch
literal 2211
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

literal 0
HcmV?d00001

diff --git a/content/markdown/introduction-to-markdown.md b/content/markdown/introduction-to-markdown.md
index a1208ba..9b0535d 100644
--- a/content/markdown/introduction-to-markdown.md
+++ b/content/markdown/introduction-to-markdown.md
@@ -45,12 +45,12 @@ This gets rendered as
 This is **bold text**.
 
 ```markdown
-This is also **bold text**.
+This is also __bold text__.
 ```
 
 This gets rendered as
 
-This is also **bold text**.
+This is also __bold text__.
 
 ### Italics
 
@@ -62,12 +62,12 @@ to get the same effect.
 Here are a few examples.
 
 ```markdown
-This is _italic text_.
+This is *italic text*.
 ```
 
 This gets rendered as
 
-This is _italic text_.
+This is *italic text*.
 
 ```markdown
 This is also _italic text_.
@@ -77,6 +77,32 @@ This gets rendered as
 
 This is also _italic text_.
 
+### Strikethrough
+
+To strikethrough use `~~` around the text.
+
+```markdown
+This is ~~strikethrough text~~.
+```
+
+is rendered as
+
+This is ~~strikethrough text~~.
+
+### Footnotes
+
+To add footnotes use the syntax `[^name]` inline, and define them with:<br>
+`[^name]:text.` 
+
+```markdown
+Text with a footnote.[^1]
+[^1]: A footnote.
+```
+is rendered as 
+
+![Footnote Example rendering](/images/markdown/Footnote-example.png)
+
+
 ## Forgejo-specific formatting
 
 ### Emoticons
@@ -128,3 +154,4 @@ E.g.
 is rendered to:
 
 ![Mermaid Example rendering](/images/markdown/mermaid-example.png)
+