gitea icon indicating copy to clipboard operation
gitea copied to clipboard

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

Open nschloe opened this issue 1 year ago • 5 comments

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 https://github.com/go-gitea/gitea/issues/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

nschloe avatar Oct 16 '23 13:10 nschloe