backtick math

[nschloe]

Feature Description

GitLab and GitHub both have support for backtick math, i.e.,

The Pythagorean theorem can be written as an equation
relating the lengths of the sides $`a`$, $`b`$ and the
hypotenuse $`c`$:

```math
a^2 + b^2 = c^2.
```

The Pythagorean theorem can be written as an equation relating the lengths of the sides $a$, $b$ and the hypotenuse $c$:

$$a^2 + b^2 = c^2.$$

The backticks avoid problems with accidental markdown sanitation in math content (which causes many problems for GitHub). The backticks suggests to the sanitizer that this is "code", not be touched.

GitLab started out with only the backticked mode in 2016. (They've added an imperfect dollar mode now.)

Right now, Gitea has no proper support for backticked math. Inline backticks

$`a + b = c`$

are literally rendered as backticks,

and display-block backticks are rendered, but not centralized:

```math
abc
```

$$
abc
$$

Using backticks in math also has the advantage that other Markdown software, e.g., linters or formatters, can be run on the file without modification.

It'd be great if Gitea could support backticked math as well.

Edit: I've surveyed math syntaxes and performance on GitHub, Gitea, GitLab.. Gitea's bracket-syntax is unique and hence not compatible. The backticked syntax is sorely missing from Gitea, especially given its great performance on the other platforms.

[nschloe]

I see there is some discussion on this on the corresponding PR from Sep 2022. One of the participants repeats some points I've made concerning the GitHub $-math implementation (see here). GitHub struggles with their math implementation to this day (see here), but Gitea got many things right straight away. Great! Still, I believe using the $-syntax is a mistake; you'll always find yourself fighting with Markdown, and things like

The $n$th apple costs $$(n+1)$.

will probably never render correctly. (LaTeX has \$, Markdown doesn't.) Compare that with backticks:

The $`n`$th apple costs $$`(n+1)`$.

The $n$th apple costs $$(n+1)$.

Using backticks plays nicely with Markdown and avoids all kinds of problems. And this doesn't mention the straightforward implementation of it.

[eeyrjmr]

These mathblocks exist for gitea, does this help?

(...), [...], $...$ and $$...$$

[nschloe]

@eeyrjmr Sorry for not being clear enough. These don't help at all, no, and that's what I'm trying to say. Markdown interferes with this syntax and will never be reliable.

Edit: Maybe \(\)/\[\] can help with rendering. Still worried about interoperability though.

Edit:: This syntax looks a little weird:

\[
\begin{align*}
a = b
\end{align*}
\]

[nschloe]

It's supported now.