MathSpecs.md

Extensions

Adds support for mathematics spans:

Math Inline

Allows to define a mathematic block embraced by $...$

This is a $math block$
.
<p>This is a <span class="math">math block</span></p>

Or by $$...$$ embracing it by:

This is a $$math block$$
.
<p>This is a <span class="math">math block</span></p>

Newlines inside an inline math are not allowed:

This is not a $$math 
block$$ and? this is a $$math block$$
.
<p>This is not a $$math
block$$ and? this is a <span class="math">math block</span></p>

This is not a $math 
block$ and? this is a $math block$
.
<p>This is not a $math
block$ and? this is a <span class="math">math block</span></p>

An opening $ can be followed by a space if the closing is also preceded by a space $:

This is a $ math block $
.
<p>This is a <span class="math">math block</span></p>

This is a $    math block     $ after
.
<p>This is a <span class="math">math block</span> after</p>

This is a $$    math block     $$ after
.
<p>This is a <span class="math">math block</span> after</p>

This is a not $ math block$ because there is not a whitespace before the closing
.
<p>This is a not $ math block$ because there is not a whitespace before the closing</p>

For the opening $ it requires a space or a punctuation before (but cannot be used within a word):

This is not a m$ath block$
.
<p>This is not a m$ath block$</p>

For the closing $ it requires a space after or a punctuation (but cannot be preceded by a space and cannot be used within a word):

This is not a $math bloc$k
.
<p>This is not a $math bloc$k</p>

For the closing $ it requires a space after or a punctuation (but cannot be preceded by a space and cannot be used within a word):

This is should not match a 16$ or a $15
.
<p>This is should not match a 16$ or a $15</p>

A $ can be escaped between a math inline block by using the escape \\

This is a $math \$ block$
.
<p>This is a <span class="math">math \$ block</span></p>

At most, two $ will be matched for the opening and closing:

This is a $$$math block$$$
.
<p>This is a <span class="math">$math block$</span></p>

Regular text can come both before and after the math inline

This is a $math block$ with text on both sides.
.
<p>This is a <span class="math">math block</span> with text on both sides.</p>

A mathematic block takes precedence over standard emphasis * _:

This is *a $math* block$
.
<p>This is *a <span class="math">math* block</span></p>

An opening $$ at the beginning of a line should not be interpreted as a Math block:

$$ math $$ starting at a line
.
<p><span class="math">math</span> starting at a line</p>

Math Block

The match block can spawn on multiple lines by having a $$ starting on a line. It is working as a fenced code block.

$$
\begin{equation}
  \int_0^\infty \frac{x^3}{e^x-1}\,dx = \frac{\pi^4}{15}
  \label{eq:sample}
\end{equation}
$$
.
<div class="math">\begin{equation}
  \int_0^\infty \frac{x^3}{e^x-1}\,dx = \frac{\pi^4}{15}
  \label{eq:sample}
\end{equation}
</div>