The Goldmark parser would treat the underscore
_ and the backslash
\ as Markdown syntax and disrupt math rendering by MathJax or KaTeX. The original parser in Hexo,
hexo-renderer-marked, also has similar issues, but it could be replaced with other ones  with serve-side math rendering that works perfectly with math blocks with good cleint-side performance.
|Clean and elegant theme||✔️||✔️||✔️|
|Fast page generation for live preview||Super fast||Fast but not live||Generates HTML on the fly|
|Rich plugin system||Not many||NPM[7:1] ecosystem||✔️ |
|Overriding default settings||✔️ ||✔️ ||✔️ (in
|Tags and categories||Orthogonal||Hierarchical||❌|
|Asset management||✔️||⚠️ ||✔️|
|LaTeX math rendering||⚠️ [^mathissue]||✔️||✔️|
|In-site search box||✔️||✔️||✔️|
|Inline rendering of videos, docs, …||✔️ (shortcodes)||✔️ (tag plugins)||✔️ (HTML tag + include link)|
- Jekyll, the default GitHub pages SSG. The performance for generating a lot of posts is to be desired.
- Nikola, a SSG with first-class support of
*.rst and *.ipynb` files.
- JupyterBook, building beautiful, publication-quality books and documents from computational material with executable code blocks. It supports (extended)
*.ipynb[14:1] and is built on Sphinx.
- fastpages, an easy to use blogging platform Built on Jekyll and GitHub actions, with enhanced support for Jupyter Notebooks (but you still eed escaping sequence for LaTeX math).
My template sites, fell free to use them.
In Hugo, you are able to override the default layout / settings by placing a counterpart file in your site without messing with the theme folder, which is Much more friendly for Git submodules and theme updates. While in Hexo, you may need to edit the settings inside the themes folder, causing conflicts when the theme updates. ↩︎