Contents
Converting LaTeX to Markdown/MathJax
- Replace all
\textbf{abc}with**abc**, and similarly for italics- Find What:
\\textbf{([^}]+)} - Replace With:
**$1**
- Find What:
-
Replace
\begin{enumerate} ... \end{enumerate}with actual numbering - Replace
\href{link}{text}with[text](link)- Find What:
\\href{(.+)}{(.+)} - Replace With:
\[$2\]\($1\)
- Find What:
-
Make sure all
$$ ... $$equations have a newline above and below. This prevents these equations from being treated as inline equations. - Replace all
$ ... $with$$ ... $$. (This assumes that single dollar signs have not been configured as delimiters for inline math.)- Find What:
([^$])\$([^$]+)\$([^$]) - Replace With:
$1\$\$$2\$\$$3
- Find What:
- Surround all LaTeX math-mode blocks (such as
\begin{align} ... \end{align}) with$$ ... $$. This apparently tells the kramdown processor to avoid treating underscores_within math equations as italics.
MathJax Configuration Options
MathJax can be configured to enable optional behavior, including automatic line breaks and support for additional inline math delimiters. These are options that I have played with, but I am wary of their drawbacks and therefore have decided to hold off on enabling them. The automatic line breaks do not account for equation formatting, so they tend to be ugly. Also, using single dollar signs for inline math would require escaping normal dollar signs when writing about currency. However, I am including the following code block for future reference, should I decide to enable these options. The code block would need to come before the <script> tag that links to the actual MathJax .js file.
<script type="text/x-mathjax-config">
MathJax.Hub.Config({
// enable automatic line breaks (might look ugly)
CommonHTML: { linebreaks: { automatic: true } },
"HTML-CSS": { linebreaks: { automatic: true } },
SVG: { linebreaks: { automatic: true } },
// enable $ for inline math -> use \$ for ordinary dollar-sign
tex2jax: {
inlineMath: [['$','$'], ['\\(','\\)']],
processEscapes: true
},
});
</script>
Additionally, MathJax’s accessibility extension MathJax-a11y is supposed to support “smart” auto-collapsing equations. I tried to follow the documentation but was unsuccessful.