From 45aad24e667ee7b180393d558fb130bb482577c3 Mon Sep 17 00:00:00 2001 From: Ryan Watters Date: Fri, 31 Mar 2017 19:53:13 -0500 Subject: [PATCH] Add note on Mmark with MathJax to formats doc --- content/content-management/formats.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/content/content-management/formats.md b/content/content-management/formats.md index b7d77500e..491a2ae5d 100644 --- a/content/content-management/formats.md +++ b/content/content-management/formats.md @@ -113,7 +113,7 @@ MathJax is a stable open-source library with many features. I encourage the inte ### Issues with Markdown -After enabling MathJax, any math entered in-between proper markers (see documentation) will be processed and typeset in the web page. One issue that comes up, however, with Markdown is that the underscore character (`_`) is interpreted by Markdown as a way to wrap text in `emph` blocks while LaTeX (MathJax) interprets the underscore as a way to create a subscript. This "double speak" of the underscore can result in some unexpected and unwanted behavior. +After enabling MathJax, any math entered between proper markers (see the [MathJax documentation][mathjaxdocs]) will be processed and typeset in the web page. One issue that comes up, however, with Markdown is that the underscore character (`_`) is interpreted by Markdown as a way to wrap text in `emph` blocks while LaTeX (MathJax) interprets the underscore as a way to create a subscript. This "double speak" of the underscore can result in some unexpected and unwanted behavior. ### Solution @@ -151,6 +151,10 @@ MathJax.Hub.Config({ ``` {{% /code %}} +{{% note %}} +If you are using Mmark with Mathjax, use `displayMath: [['$$','$$'], ['\\[','\\]']]`. +{{% /note %}} + As before, this content should be included in the HTML source of each page that will be using MathJax. The next code snippet contains the CSS that is used to have verbatim MathJax blocks render with the same font style as the body of the page. {{% code file="mathjax-style.css" %}} @@ -204,6 +208,7 @@ Markdown syntax is simple enough to learn in a single sitting. The following are [hl]: /tools/syntax-highlighting/ [hlsc]: /content-management/shortcodes/#highlight [hugocss]: /css/style.min.css +[mathjaxdocs]: https://docs.mathjax.org/en/latest/ [mdcheatsheet]: https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet [mdtutorial]: http://www.markdowntutorial.com/ [org]: http://orgmode.org/