bracket syntax \(\)\[\] for math problematic

[nschloe]

Description

Here's another issue with the bracket syntax: \[ and \] are actually valid Markdown characters (see Markdown definition here), rendering to [ and ], respectively. The escaping is to set brackets apart from Markdown links à la [abc](https://example.com). Markdown formatters like prettier or mdformat escape brackets in various places, accidentally producing Gitea math. (See here for the corresponding mdformat bug.)

Related to #27602.

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.

Gitea Version

1.22.0+dev-188-g1be49fdda

Can you reproduce the bug on the Gitea demo site?

Yes

Log Gist

No response

Screenshots

No response

Git Version

No response

Operating System

No response

How are you running Gitea?

https://try.gitea.io/

Database

None

[jamesbraza]

@nschloe did you try using the mdformat-myst plugin? See executablebooks/mdformat#334

[nschloe]

Yeah, same result with

import mdformat

print(mdformat.text("[a]", extensions={"myst"}))

\[a\]

[jamesbraza]

Thought it was worth a shot haha, sorry. Hope this gets resolved! You can also try prettier while mdformat isn't compatible

[nschloe]

As mentioned in my original post, prettier also escapes square brackets (though not always, as mdformat does).