TeXify2 is a minimal, LaTeX-style Hugo theme for personal blogging, built as the successor to the original TeXify theme and available under the MIT license. It takes standard Markdown content and renders a clean, academic-looking blog with KaTeX math support, Mermaid diagrams, and a no-JavaScript, CSS-only layout.
What is TeXify2?
TeXify2 is a Hugo theme designed for personal blogs that want a LaTeX-document aesthetic. It converts Hugo content files (Markdown) into static HTML pages with automatic section numbering, reading-time estimates, and word counts. The theme is developed by weastur and is the documented successor of the TeXify theme by queensferryme. It requires Hugo version 0.113 or newer and is tested on Chrome, Safari, Edge, and Firefox.
Key Features
- KaTeX math rendering — MathJax has been removed; equations are typeset with KaTeX for fast client-side rendering.
- Mermaid diagram support — Include flowcharts and sequence diagrams in your posts via the Mermaid syntax.
- DuckDuckGo search — A built-in search interface powered by DuckDuckGo, with no external search index required.
- Any comment engine — Works with giscus, remark42, Hyvor, and other comment systems; Disqus is also included.
- Word Counter and Reading Time — Automatically displays estimated reading time and word count for each post.
- Social sharing buttons — Standard share buttons for social platforms, generated without JavaScript.
- Hugo modules support — Install the theme as a Hugo module or as a git submodule; both workflows are documented.
- Configurable root font size — Adjust the base font size via configuration to match your typographic preference.
- Auto numbered subtitles — Headings can be automatically numbered in LaTeX style.
- BuyMeACoffee widget — A donor widget can be placed in the layout.
- Minimal CSS, no JavaScript — The default layout relies on minimal custom CSS; the theme's feature list touts "Blazing Fast" performance due to the absence of JavaScript dependencies.
Who is it for?
- Academic or technical bloggers — Write posts with LaTeX-style math and code, and have them rendered in a clean, KaTeX-powered layout.
- Minimalist writers — Writers who want a distraction-free reading experience with word count, reading time, and simple typography.
- Self-hosters — Developers who run Hugo and want a theme that can be installed either as a git submodule or as a Hugo module, with no build step beyond Hugo itself.
- Open-source maintainers — The theme ships with pre-commit hooks for development and is MIT-licensed.
What can you do with TeXify2?
- Publish a personal blog — Set up a Hugo site with the theme, add Markdown posts, and automatically get automatic subtitles and a responsive mobile layout.
- Display math-heavy content — Use KaTeX to render inline and display equations in posts without loading MathJax.
- Add diagrams — Embed Mermaid diagrams in your articles and have them render as flowcharts, sequence diagrams, or gantt charts.
- Monetize with donations — Place a BuyMeACoffee widget to collect contributions from readers.
How does TeXify2 work?
Installation is done either as a git submodule or as a Hugo module. As a submodule, add the repository to your themes directory and set the theme name in your configuration. As a Hugo module, import the GitHub path in your project's module configuration and run hugo mod get -u to fetch updates. The theme reads the same hugo.toml configuration used by Hugo; a full example configuration is included in the theme's repository.
Alternatives
- TeXify — the original theme that TeXify2 replaces, also a LaTeX-style Hugo theme.
- HugoTeX — another LaTeX-inspired Hugo theme listed among the design inspirations.
FAQ
Is TeXify2 free?
Yes, TeXify2 is open-source and released under the MIT license, so you can use, modify, and redistribute it freely.
Does TeXify2 support math equations?
Yes, math is rendered with KaTeX. MathJax was deleted from the theme in favor of KaTeX, which loads faster.
How do I install TeXify2?
You can install it either as a git submodule (via git submodule add https://github.com/weastur/hugo-texify2.git themes/hugo-texify2) or as a Hugo module by importing github.com/weastur/hugo-texify2 in your Hugo configuration.
The theme is compatible with any comment engine, including giscus, remark42, Hyvor, and Disqus. The demo site enables all features, but you can disable them per project.
Does the theme work on mobile?
Yes, the layout is responsive and the theme is tested on Chrome, Safari, Edge, and Firefox.
