Kramdown does not seem to render math blocks

[TMorville]

• This is a question about using the theme.
• I believe this to be a bug with the theme --- not Jekyll, GitHub Pages or one of the bundled plugins.
• This is a feature request.
• I have updated all gems with bundle update.
• I have tested locally with bundle exec jekyll build.

---

Environment informations

• Minimal Mistakes version: 4.1.1
• github-pages or jekyll gem version: github-pages 91
• Operating system: OS x Sierra 10.12.2

---

Expected behavior

Kramdown does not render math when using the $$ \equation $$ syntax as prescribed on https://kramdown.gettalong.org/syntax.html#math-blocks.

Steps to reproduce the behavior

Here is a link to my repo. As you can see under e.g. under inverted pendulum.md there should be two bits of math $$ x_t $$ and $$\theta_t$$ which should display as math. But when building (or serving), it does not render.

I have forked Minimal Mistakes and implemented as shown. Everything else works fine.

Here are my _congif.yml settings for markdown:

Conversion

markdown: kramdown
highlighter: rouge
lsi: false
excerpt_separator: "\n\n"
incremental: false

Markdown Processing

kramdown:
input: GFM
hard_wrap: false
auto_ids: true
footnote_nr: 1
entity_output: as_char
toc_levels: 1..6
smart_quotes: lsquo,rsquo,ldquo,rdquo
enable_coderay: false

[mmistakes]

As per Krandown's docs you need to add the MathJax JavaScript library for it work. https://www.mathjax.org/

[TMorville]

Adding

<script type="text/javascript" async
  src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-MML-AM_CHTML">
</script>

manually to my .md posts worked perfectly. Thanks. Any ideas on how to implement this in a more permanent manner?

[justinrummel]

For scripts that I want to add on every page, I usually add them to the _include/scripts.html page. I've also done some IF statements (which I'm sure are not the best way to do this) to see if I'm loading the main page or a "Search" page as seen on my repo: scripts.html

[mmistakes]

You can add it to scripts.html or any of the two custom includes I've added to the theme for injecting scripts in the head or footer.

/_includes/head/custom.html
/_includes/footer/custom.html

[mmistakes]

I'd add it using a conditional like @justinrummel suggested to avoid embedding the script on pages that don't need MathJax.

/_includes/scripts.html is probably the best place for it, but it can be added to one of the custom includes if you want to maintain to avoid messing with the main theme files.

Either way something like this:

{% if page.mathjax %}
<script type="text/javascript" async
  src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-MML-AM_CHTML">
</script>
{% endif %}

And then in your post/page's YAML Front Matter you'd add mathjax: true if you wanted the script embedded.

[TMorville]

@mmistakes perfect. That solution works like a charm. Thanks.

[yuzhangbit]

I have a question related to this topic. If I enable the MathJax like what @mmistakes said, the math equations can show up normally on the page of posts. But the the author profile is gone in the post that is using the single layout. As long as I remove the equation, the author profile will show up. It seem the $$ causes the problem. Any solution to this problem? Thank you ~

[mmistakes]

@yuzhangbit You have an example? My gut is telling me there's something with the MathJax script or possibly some sort of CSS interference. But without seeing the code it's hard to say.

[yuzhangbit]

@mmistakes Thanks for your reply.
This is my repo.
Here is the example post.
If you remove the latex math code

$$SE2$$  
$$SE(3)$$

the author profile will show up.

I add the MathJax script

{% if page.mathjax %}
<script type="text/javascript" async
  src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-MML-AM_CHTML">
</script>
{% endif %}

to this file.

[mmistakes]

@yuzhangbit Does that post have the equation added? I'm not seeing any sort of layout issues and the author sidebar is present.

[yuzhangbit]

@mmistakes Yes. There are two latex math symbols(se2, se3). The sidebar doesn't show up in the desktop browser. I am using Chrome.

[mmistakes]

I just tried it in Chrome on the desktop and the sidebar is there.

You sure you don't have any sort of adblocker extensions installed? They often kill social links and that would explain why the sidebar is gone. Other than that I really don't have any other suggestions as I can't seem to reproduce the issue.

[yuzhangbit]

@mmistakes Thank you very much! It seems it's the chrome extensions cause the problem.