Incorrect KaTex markdown rendering with \[ sequence

[silverwind]

Description

Given this markdown:

-   \[CSS] - Nested atRule's `@media` or `@supports` now properly are replaced with unique identifiers by [@​noreiller](https://github.com/noreiller) in https://github.com/webpack/webpack/pull/15812

It renders

It should render like GitHub

Gitea Version

main

Can you reproduce the bug on the Gitea demo site?

Yes

[silverwind]

So I think the bug is in the backend where it detects \[CSS] as math content. I think we need to be more strict and require the $$ wrapping around math, like below:

$$\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)$$

[nschloe]

Gitea was one of the first services to offer math support using a \(...\)/\[...\] syntax. Unfortunatly, it has not been adopted by any other platform, perhaps also because of the fact that it collides with standard Markdown syntax. (More about this in #27645.)

Right now, GitLab, GitHub, and Pandoc support two syntaxes:

• $...$/$$...$$ (traditional TeX),
• $`...`$/ ```math... ``` (originally introduced by GitLab in 2016).

In a survey across GitHub, GitLab, Gitea, and Pandoc, I've found that the $-syntax is error prone, also because it's non-native to Markdown. The backticked syntax (not supported by Gitea right now) is a great practical alternative.

For full compatibility with other platform, perhaps Gitea can think about sunsetting the bracket syntax for math, and add the backticked syntax. This would also fix this bug here.

[wxiaoguang]

Will be fixed by #32831

[wxiaoguang]

The \[ ... ] has been fixed in #32831, but the \[ ... \] is still problematic, I have left a TODO in code, we should drop this "math" syntax in the future by a config option.

[wxiaoguang]

The complete fix is Fix markdown render behaviors #34122