[Bug Report] [documentation] The LaTeX math is not rendering properly (`$$`)

[Kallinteris-Andreas]

Describe the bug

example: https://gymnasium.farama.org/main/environments/mujoco/ant/#rewards

Code example

No response

System info

No response

Additional context

There was a discord thread about that https://discord.com/channels/961771112864313344/1007727212042129409/1133757126808969216

Checklist

• [X] I have checked that there is no similar issue in the repo

[pseudo-rnd-thoughts]

Looking around the Box documentation has properly rendering maths here which uses "math:equation" style. However if I change the Ant documentation to use this style (regenerated the markdown) then build the website again locally and it doesn't apply mathjax, it is just "math:equation".

I suspect that the difference is that sphinx autocode is adding the maths rendering while the markdown to HTML is not.

I found this solution https://github.com/readthedocs/recommonmark/issues/133 but it didn't work either. Also I added 'sphinx.ext.mathjax' to the conf.py and nothing changed either

@mgoulao Any ideas?

[Kallinteris-Andreas]

Here is a fun fact, I found there are 50+ flavors for Markdown https://github.com/commonmark/commonmark-spec/wiki/Markdown-Flavors

This appears to work with python markdown:

{math} `2^2 + 3 = 7`

[mgoulao]

We use MyST as the Markdown parser. I think the problem is now fixed from the sphinx theme side (Celshast), so no need to merge #843 .

[Kallinteris-Andreas]

@mgoulao, but it is not working see https://gymnasium.farama.org/main/environments/mujoco/ant/#rewards

[mgoulao]

I know, we need to wait for the next commit to see if the fix worked

[pseudo-rnd-thoughts]

Any update on this?

[Kallinteris-Andreas]

Appears to be fixed https://gymnasium.farama.org/main/environments/mujoco/ant/#rewards

Thanks! @mgoulao