From 9a59a36913e8fb2fe735fce940e0413295853d68 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Oto=20=C5=A0=C5=A5=C3=A1va?= Date: Mon, 25 Nov 2024 11:56:27 +0100 Subject: [PATCH] user/wiki: document KaTeX --- docs/_images/user/wiki/katex_example.png | Bin 0 -> 13267 bytes docs/user/wiki.md | 14 ++++++++++++++ 2 files changed, 14 insertions(+) create mode 100644 docs/_images/user/wiki/katex_example.png diff --git a/docs/_images/user/wiki/katex_example.png b/docs/_images/user/wiki/katex_example.png new file mode 100644 index 0000000000000000000000000000000000000000..2a2906de0d2fb8a5e5da93d17a4512165aec354b GIT binary patch literal 13267 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 z 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 literal 0 HcmV?d00001 diff --git a/docs/user/wiki.md b/docs/user/wiki.md index 748add12..ba2a2a08 100644 --- a/docs/user/wiki.md +++ b/docs/user/wiki.md @@ -110,3 +110,17 @@ Very basic example for a sidebar: > These files starting with `_` are hidden, so in the web UI you need to manually browse for the files. E.g. for our user _knut_ and his _foobar_ repo: > `https://codeberg.org/knut/foobar/wiki/_Sidebar` + +## Embedding LaTeX-style equations + +The wiki also supports embedding LaTeX-style equations in Markdown files, using [KaTeX](https://katex.org). + +Such equations go between two `$` characters, for example like this: + +```markdown +$ \frac{1}{2} = 0.5 $ +``` + +This will then result in the following properly rendered equation: + +![The $\frac{1}{2} = 0.5$ equation properly rendered by KaTeX](../_images/user/wiki/katex_example.png)