FYI:

when writing the sphinx docs, I use the following regular expression in Emacs's query replace regexp command:

from

$([^$]+)$

to

:math:\1

That way I can write the inline math (on a single line!) using the usual $ signs and replace them just before making the docs. Simple, but helps.

r.