From 858f83081f9f2fc08c331390625656f9951787cc Mon Sep 17 00:00:00 2001
From: Harry Mellor <19981378+hmellor@users.noreply.github.com>
Date: Mon, 17 Mar 2025 16:18:54 +0000
Subject: [PATCH] Add `MathJax` support

Signed-off-by: Harry Mellor <19981378+hmellor@users.noreply.github.com>
---
 README.md                  | 16 ++++++++++++++++
 _includes/custom-head.html | 12 ++++++++++++
 2 files changed, 28 insertions(+)
 create mode 100644 _includes/custom-head.html

diff --git a/README.md b/README.md
index f3aeda4..33f7f82 100644
--- a/README.md
+++ b/README.md
@@ -15,6 +15,22 @@ To add a new blogpost, please refer to `_posts/2023-06-20-vllm.md` as an example
 
 The blog is automatically built and deployed by GitHub Actions when `main` is pushed to.
 
+## LaTeX Math
+
+The blog supports LaTeX math via [MathJax](https://docs.mathjax.org/en/latest/index.html). 
+
+It can be enabled by adding `math: true` to the document frontmatter. It has been configured to support the standard LaTeX style math notation, i.e.:
+
+```latex
+$ inline math $
+```
+
+```latex
+$$
+math block
+$$
+```
+
 ## Theme customization
 
 The theme we are using is [Minima](https://github.com/jekyll/minima). If you need to customise anything from this theme, see [Overriding theme defaults](https://jekyllrb.com/docs/themes/#overriding-theme-defaults).
\ No newline at end of file
diff --git a/_includes/custom-head.html b/_includes/custom-head.html
new file mode 100644
index 0000000..6b553b4
--- /dev/null
+++ b/_includes/custom-head.html
@@ -0,0 +1,12 @@
+{% if page.math %}
+<script>
+    MathJax = {
+        tex: {
+            inlineMath: [['$', '$'], ['\\(', '\\)']],
+            displayMath: [['$$', '$$'], ['\\[', '\\]']]
+        }
+    };
+</script>
+<script id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml.js">
+</script>
+{% endif %}
\ No newline at end of file