If you simply allow GitHub Pages to render your Markdown files into HTML without customizing the rendering yourself via something like Jekyll or another static site generator, then no. The default rendering of Markdown to HTML via GitHub Pages doesn’t include anything like MathJax for displaying formatted math formulae.

If you use Jekyll (or another static site generator), then you could change the default template to include MathJax like I’ve done on my GitHub Pages website:

lee-dohm/lee-dohm.github.io/blob/77260089817da592b570b64a33f5642dca60a9b9/_layouts/base.html#L20-L23

<!-- MathJax -->
<script type="text/javascript"
  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.3/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
</script>

I hope that helps!

I have no issues using Jekyll to generate my site (and then pushing the HTML). However, when I tried to use Jekyll, all I can see is the blogging feature.

To be more specific, say, I have a README.md file in my repo (with a relative link to foo/bar.md . (Both the markdown files contain math).

Now, I want to use Jekyll to convert these markdown files to HTML (with math included). I don’t want to use any other feature of Jekyll (more specifically, I don’t need a posts folder).

So, how would I go about implementing this?

I understand it’s not a domain of Github, but thanks in advance.

(Or is it not possible to convert a set of already existing markdown files on Github to HTML via Jekyll)?

You can use Jekyll without the blog functionality. If you take a look at the repository for my website, you’ll notice that I have a mixture of blog and non-blog content in there. The blog functionality is there to optimize for the most common use of static site generators, blog-like structures. If you want to have just a bunch of pages that you manually control the structure of, you can do that by linking to where they’re going to be generated into position like I do here:

lee-dohm/lee-dohm.github.io/blob/77260089817da592b570b64a33f5642dca60a9b9/_layouts/base.html#L57-L61

<li><a href="/about">About Lee</a></li>
<li><a href="/this-blog">About This Blog</a></li>
<li><a href="/appearances">Appearances</a></li>
<li><a href="/colophon">Colophon</a></li>
<li><a href="/disclaimer">Disclaimers</a></li>

Thanks for the insights. I’ll take a look at your repo and (hopefully) setup my own. Have a good day!

Also, slightly off topic, but do you know a workaround for jumping from GH-Pages to Github? The rules for redirection are fairly simple, (as you just need to add blob/master and do a small change in the url (which is just 1 or 2 lines of code using regex). I was surprised there wasn’t any plugins for this yet. My question is : Can I somehow tweak the source code to include a button that lets me jump to the file location on Github?

Right, Improve on Github as mentioned here was exactly what I was looking for.

I think I can take it from here. Thanks for the help!

A while ago I created xhub, a browser extension that allows you to use math in github pages.

Cons:

• You have to install the extension.

Pros:

• No need to set up any workflow.
• Just edit your markdown as usual and use

  Display math:
  ```math
  e^{i\pi} + 1 = 0
  ```
  and inline math $`a^2 + b^2 = c^2`$.
  

• Works well on light and dark background.
• You can even copy-and-paste the math!

Perhaps worth checking out.

screenshot1178×398 21.1 KB

Very interesting and useful. The extension can also be used in Edge.

However, the pages can not display the mathematics properly when the pages are built into web in Github. It only works on the original Github Markdown files.

What does it mean using a chrome extension to add math to github pages? Will all visitors be able to properly see my formulas?!?