Note: I didn't create this post. The original author is here.
\textbf{abc} with **abc**, and similarly for italics\\textbf{([^}]+)}**$1**Replace \begin{enumerate} ... \end{enumerate} with actual numbering
Replace \href{link}{text} with [text](link)
\\href{(.+)}{(.+)}\[$2\]\($1\)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.)
([^$])\$([^$]+)\$([^$])$1\$\$$2\$\$$3\begin{align} ... \end{align}) with $$ ... $$. This apparently tells the kramdown processor to avoid treating underscores _ within math equations as italics.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.