Lithium - A simple responsive Hugo theme
HTML CSS JavaScript
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 73 commits ahead, 11 commits behind jrutheiser:master.
Latest commit e695915 Jul 18, 2018

Hugo Lithium

A simple responsive blog theme for Hugo forked from with modifications to make it work better with blogdown.

The easiest way to get started is to create a new (empty) RStudio project, then

devtools::install_github('rstudio/blogdown')  # install blogdown
blogdown::new_site(theme = 'yihui/hugo-lithium')

Then you should be able to see an example website launched in the RStudio Viewer.

For the full documentation, please see this section in the blogdown book:


  • Blog
  • Responsive
  • Disqus
  • Google Analytics
  • Google web fonts (Merriweather and Lato)
  • MathJax
  • highlight.js


The main changes I made to the original hugo-lithium-theme are:

  1. Added support for MathJax (for rendering LaTeX math expressions) and highlight.js (for syntax highlighting).

    • For both libraries, you can specify the CDN host (e.g., CloudFlare, BootCDN, ...).

    • For highlight.js, you can specify additional languages (e.g., r, yaml, tex, ...).

  2. Added Google web fonts (embedded in the theme so that visitors from countries where Google is banned can still see the typefaces).

  3. Improved Hugo's built-in Disqus template, so that you can actually the comments even when you are previewing the website locally.

  4. Replaced the variable .Permalink with .RelPermalink, and function absURL with relURL where necessary. It is a bad idea to use full absolute links (with the protocol and domain) in general. For example, .Permalink and absURL may generate URLs of the form, but /foo/bar.html is more portable.


The original hugo-lithium-theme was released by Jonathan Rutheiser under the MIT License. The modified version in this repository is also released under MIT.