<div>Dear ipython developers,</div><div><br></div><div>Apologies for the imprecise language, I don't have a perfect feel for the various ipython components yet, so I'll use general terms to describe the issue at hand.</div>
<div><br></div>It is convenient MarkDown+LaTeX notation to write a multiline equation with something like this:<div><br></div><div><div>$$</div><div>\begin{align*}</div><div>u_t(x,t) & = f(x,t) \\</div><div>u(x,0) & = u_0</div>
<div>\end{align*}</div><div>$$</div></div><div><br></div><div>We use the $$ to deliberately enter "math mode", telling the markdown editor that it is no longer responsible for rendering anything until the next $$.  MathJaX takes over here, and is responsible for properly formatting and rendering the math in equation-rendering mode.</div>
<div><br></div><div>Unfortunately, it looks like the Markdown parser being used in the notebook is unaware of equation mode, and is still trying to "munch" the backslashes before they get handed to MathJaX for rendering, forcing me to markup my equations like this:</div>
<div><br></div><div><div>\begin{align*}</div><div>u_t(x,t) & = f(x,t) \\\\</div><div>u(x,0) & = u_0</div><div>\end{align*}</div></div><div><br></div><div>This seems to be a general problem with the ipython notebook markdown renderer.  I've noticed that I can slip other pieces of Markdown formatting into an equation (regardless of whether I have specified math mode or entered an equation block) and totally break MathJax's rendering.  </div>
<div><br></div><div>Here's my proposal:</div><div><br></div><div>Modify/patch/preprocess the Markdown code being used by ipython to render the web pages so that any text bracketed by $$ is passed completely raw to MathJaX.  </div>
<div><br></div><div>I think this will fix the issues I'm seeing with backslashes as well as bring the Markdown+LaTeX notation into consistency with that used by other editors of this nature such as StackExchange and gitit.</div>
<div><br></div><div>Cheers,</div><div>Aron</div>