Inline math doesn't render correctly when inside a Markdown table

[michaelosthege]

I have a notebook containing a Markdown table like this:

first	second
$$x \in \mathcal{R} $$	👈 this one renders, but distorts the layout
$x \in \mathcal{R} $	👈 this one doesn't render

After building the docs with Sphinx, I get this:

I tried to add more text before & after the math to illustrate the problem with the $$ version, but it didn't work.
The error hints that the problem may arise from the RST intermediate representation (probably related to #36).

+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| first                                                                                                                                                                                                                                                   | second
                                                                                                                                         |
+=========================================================================================================================================================================================================================================================+=========================================================================================================================================================================================================================================================+
| not inline                                                                                                                                                                                                                                              | 👈 this one renders, but distorts the layout
                                                                                                                                          |
|                                                                                                                                                                                                                                                         |
                                                                                                                                         |
| .. math:: x \in \mathcal{R}                                                                                                                                                                                                                             |
                                                                                                                                         |
|                                                                                                                                                                                                                                                         |
                                                                                                                                         |
| \ math                                                                                                                                                                                                                                                  |
                                                                                                                                         |
+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| inline $x :nbsphinx-math:`\in `:nbsphinx-math:`\mathcal{R}` $ math                                                                                                                                                                                      | 👈 this one doesn’t render
                                                                                                                                          |
+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

[mgeier]

Sorry for the late response, especially since the answer is quite simple:

• never use $$. For block equations, use LaTeX environments instead, like

  \begin{equation*}
  a + b
  \end{equation*}
  

• use $ for inline equations, but make sure to avoid additional spaces at the beginning and end (see the first "Note" at https://nbsphinx.readthedocs.io/en/0.8.8/markdown-cells.html#Equations)

Long story short, use $x \in \mathcal{R}$ and everything should be fine.

[michaelosthege]

Thank you, @mgeier !
I didn't notice the spaces and wouldn't have expected them to be a problem.