Jekyll Theme Solid is a Jekyll blog theme that generates static websites with no JavaScript, built for GitHub Pages.
What is Jekyll Theme Solid?
Jekyll Theme Solid is a minimal Jekyll theme that produces clean, static HTML pages from Markdown content written in YAML front matter. It runs on the Jekyll static site generator, so you author posts in Markdown and the theme uses Liquid templates to render a complete site as a folder of static files ready to upload to GitHub Pages or any static web host. The theme is stored in a public GitHub repository with a live demo available at mazhuang.org/jekyll-theme-solid, where you can see the home page and post page layouts in action. Its defining trait is the complete absence of JavaScript: the theme ships no script files, so all content renders as plain HTML and CSS, and no client-side code is loaded at all.
Key Features
- No JavaScript — The theme includes zero JavaScript files, so pages load without any client-side scripting and remain fully readable even with JavaScript disabled in the browser.
- Jekyll-based templating — Uses Jekyll's Liquid template language and YAML front matter for post metadata, so you control layout and content structure through familiar Jekyll conventions.
- GitHub Pages ready — Because Jekyll is natively supported by GitHub Pages, you can deploy the theme by referencing the repository in your site's configuration without extra build steps.
- Simple home page — The home page displays a dated list of recent posts, per the project screenshot, giving visitors a straightforward index to your blog.
- Clean post page — The post layout focuses on typography and white space, presenting article content in a distraction-free reading format, as shown in the second screenshot.
- Open source on GitHub — The theme's repository is publicly available and has gathered 35 stars at the time of this writing, with a demo link provided for testing.
Who is it for?
- Personal bloggers — Write and publish a personal blog with a fast, minimal reading experience; the no-JavaScript approach keeps pages light and quick to load.
- Developers — Set up a clean blog using the Jekyll toolchain they already use, with Markdown content, Liquid templates, and YAML front matter for configuration.
- GitHub Pages users — Anyone who wants to host a simple site on GitHub Pages with a theme that requires no custom JavaScript and works directly from the repository.
Use cases
- Personal blog: Publish Markdown-based posts and have them rendered into a static blog with an index page linking to each article.
- Technical writing: Share code snippets and technical notes in a layout that stays legible without JavaScript-powered syntax highlighters or client-side processing.
- Minimal portfolio: Present a short biography and links to projects using the clean post layout, even if the theme is primarily blog-oriented.
