<div>Dear ipython developers,</div><div><br></div><div>Apologies for the imprecise language, I don&#39;t have a perfect feel for the various ipython components yet, so I&#39;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) &amp; = f(x,t) \\</div><div>u(x,0) &amp; = u_0</div>
<div>\end{align*}</div><div>$$</div></div><div><br></div><div>We use the $$ to deliberately enter &quot;math mode&quot;, 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 &quot;munch&quot; 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) &amp; = f(x,t) \\\\</div><div>u(x,0) &amp; = 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&#39;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&#39;s rendering.  </div>
<div><br></div><div>Here&#39;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&#39;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>