Newsletter
Join the Community
Subscribe to our newsletter for the latest news and updates
A lightweight, clean Jekyll theme for GitHub Pages, focused on fast loading and a minimal reading experience.
Hydrogen is a lightweight, clean Jekyll blog theme built for GitHub Pages, designed to render a minimal reading experience with fast loading. It turns a standard Jekyll site into a personal blog with configurable theming, pagination, MathJax rendering, and support for pinned posts and friend links.
Hydrogen is a Jekyll theme created by developer link9596, with a live demo at atlinker.cn. It takes a Jekyll site's Markdown posts and configuration in _config.yml as input, and produces a static blog with a homepage, archive pages, and post pages. The theme is optimized for GitHub Pages deployment and is distributed with documentation in both Simplified Chinese and English. Its core goal is to avoid heavy page elements and loading overhead by using lightweight modules to render everything on screen.
# is not supported), MathJax toggle, author name, and build time timestamp directly in _config.yml.paginate option; older posts automatically flow onto subsequent pages.MathJax: true in the config, useful for technical and academic blogs.friends.yml file in the _data directory, following the included template entries.stickie: true to a post's front matter to keep it at the top of the blog listing.CNAME file with your own domain to publish the blog under a custom URL.buildtime option, the footer automatically calculates and displays how long the blog has existed.Hydrogen is aimed at individual bloggers who want a minimal, fast personal website without extraneous widgets or heavy themes. It suits developers who run Jekyll on GitHub Pages and want a theme that requires only editing YAML configuration rather than modifying templates. It is also appropriate for writers who need MathJax to display formulas and who want a simple way to manage friend links and pinned posts.
Start by placing the theme files in your Jekyll site's root directory. Edit _config.yml to set your blog title, description, and other options, then optionally modify _data/friends.yml to add linked sites. To pin a post, add stickie: true to its front matter. Push the repository to GitHub with GitHub Pages enabled, and the static site builds automatically. For a custom domain, edit the CNAME file.
Yes, the theme is publicly available on GitHub, and you can use it for personal or commercial blogs without payment. No pricing or licensing information is present in the documentation beyond the repository page.
Edit the CNAME file in the repository root, replacing its contents with your domain (for example, atlinker.cn without http:// or https://), and configure your DNS provider to point to GitHub Pages.
Open _config.yml and set MathJax: true. This enables rendering of LaTeX-style math equations in your posts. Note the option expects a boolean value.
Yes. In the article's front matter, add stickie: true. The value must be lowercase as shown. This will keep the post at the top of the homepage listing.
The theme_color option accepts rgba color codes, such as rgba(248, 187, 208, 1). It does not support hex values with a leading #, so avoid using Hex color codes for this option.
