Lightweight Jekyll theme for academic scenarios, usable for portfolios, blogs, and academic pages
jekyll-academic — Jekyll Portfolio Template
By mlian031
Jekyll Academic is a lightweight Jekyll theme for academic use, suitable for portfolio websites, blogs, and academic pages.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Provides RSS and JSON feeds
Supports a blog search bar based on tag categories
Optional Disqus comments and a custom 404 page
Markdown enhancements support Highlightjs, MathJax, ChartJs, and FontAwesome/Bootstrap Icons
SEO configuration includes robots.txt, sitemap.xml, and jekyll-seo-tag
Template Details
Jekyll Academic is a Jekyll-based theme positioned by its author as a lightweight option for academic scenarios, suitable for portfolio websites, blogs, and academic use. The theme provides RSS and JSON feeds, optional Disqus comments, a blog search bar based on tag categories, and a custom 404 page. For Markdown, it supports enhancements such as Highlightjs, MathJax, ChartJs, and FontAwesome/Bootstrap Icons. SEO-related configuration includes robots.txt, sitemap.xml, and jekyll-seo-tag. There are two installation methods: quick installation via a script, or adding jekyll-academic to the Gemfile of a Jekyll site, setting the theme in _config.yml, and running bundle install; alternatively, clone the repository directly, run bundle install, and preview locally with bundle exec jekyll serve. Before use, edit _config.yml; more configuration details are available in the project documentation. The repository uses the MIT license, and the free scope covers the code of this version; third-party assets such as demo images, fonts, and icons must be checked against their respective licenses, and external services such as domains and hosting may incur separate charges.
Is it right for your project?
Use Cases
- Building a personal academic homepage or portfolio website
- Publishing a technical or academic blog with tag categories and search
- Static sites that need RSS/JSON subscriptions and basic SEO configuration
- Content pages where you want to use mathematical formulas, charts, and icons directly in Markdown
Suitable For
- Developers or researchers building static sites with Jekyll
- Academic users who need a combined portfolio and blog site
- Users who prefer a lightweight theme and configure it by editing _config.yml themselves
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
For quick installation, run the bundle-install.sh script provided by the repository
- 2
Manual installation: add gem "jekyll-academic" to the Gemfile, set theme: jekyll-academic in _config.yml, then run bundle install
- 3
You can also clone the repository directly and run bundle install
- 4
For local preview, use bundle exec jekyll serve; the default address is localhost:4000
- 5
Site customization requires editing _config.yml; see the project documentation page for more configuration
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in the public repository; the free scope covers the code of this version and does not mean that external services or third-party assets are free.
Must comply with when using
- You may use, modify, commercialize, and distribute the code of this version for free.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- Disqus comments are optional; enabling them requires registering a Disqus account and depends on its third-party service, which may be subject to its terms of service and fee policies.
- Markdown enhancements depend on third-party libraries such as Highlightjs, MathJax, ChartJs, and FontAwesome/Bootstrap Icons; you must check their respective licenses when using and distributing them.
- The quick installation script pulls from GitHub remotely and executes directly; it requires internet access to external services, and you should review the script content before running it.
- Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur separate charges.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
Optional Disqus comments
Original README
Enhanced Markdown (Highlightjs, MathJax, ChartJs, FontAwesome/Bootstrap Icons)
Original README
https://github.com/mlian031/jekyll-academic/blob/master/LICENSE.txthttps://github.com/mlian031/jekyll-academic/blob/master/README.md$ curl -s -L https://raw.githubusercontent.com/yak-fumblepack/jekyll-academic/master/scripts/bundle-install.sh | bash
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-02. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- More documented · 77 / 100
- Technologies
- Jekyll
- Website type
- Portfolio · Blog
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2021-08-17
- Screenshot last checked
- 2026-10-02
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Jekyll as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Automatically checked against source and license rules; no manual editorial review.
Inspect the recorded source material
SHA-256: 4e32394f2ac13ff897072a5ef2ee677be7e6980e5ea1970dae9531a4ab417947
2026-10-02T10:51:58.646Z
Source file / repository# Jekyll Academic


Jekyll Academic is a lightweight theme for any academic usecase. Perfect for portfolio websites, blogs, and academia. It is a simple no nonsense theme that offers many features.
[Live preview](https://jekyll-academic.netlify.app)
- Ultra-fast serving times, only ~2.6kb of CSS
- 99/100 Performance on Lighthouse
- 100/100 SEO on Lighthouse
- RSS and JSON feed
- Enhanced Markdown (Highlightjs, MathJax, ChartJs, FontAwesome/Bootstrap Icons)
- Optional Disqus comments
- Search bar with blog categorisation based on tags
- Custom 404 page
- SEO optimised (robots.txt, sitemap.xml, jekyll-seo-tag)
## Contents
- [Jekyll Academic](#jekyll-academic)
- [Contents](#contents)
- [Installation](#installation)
- [Quick install](#quick-install)
- [Longer installation process](#longer-installation-process)
- [Usage](#usage)
- [Contributing](#contributing)
- [License](#license)
## Installation
### Quick install
```shell
$ curl -s -L https://raw.githubusercontent.com/yak-fumblepack/jekyll-academic/master/scripts/bundle-install.sh | bash
```
### Longer installation process
Add this to your Jekyll site's Gemfile:
```ruby
gem "jekyll-academic"
```
And add this line to your Jekyll site's `_config.yml`:
```yaml
theme: jekyll-academic
```
Then execute:
```shell
$ bundle install
```
or install it yourself as a Gem:
```shell
$ gem install jekyll-academic
```
OR
```shell
$ git clone https://github.com/yak-fumblepack/jekyll-academic.git
```
```shell
$ bundle install
```
Then finally to view your site (default is [localhost:4000]()):
```shell
$ bundle exec jekyll serve
```
## Usage
To make it yours, edit the `_config.yml` file or refer to our [docs](https://jekyll-academic.netlify.app/docs) for further configuration.
Have fun building your amazing site!
## Contributing
Bugfixes and features are most welcome and appreciated. For features and bugfixes, please make the pull request onto the `dev` branch. If you're looking to improve the documentation, make the pull request onto `docs-pages`.
Is there a bug? Feel free to open an issue.
## Development
Fork this repo
```shell
$ git clone https://github.com/yak-fumblepack/jekyll-academic.git/
$ cd jekyll-academic/
$ bundle install
$ bundle exec jekyll serve
```
And view it on [localhost:4000]()
Then make your amazing contributions and changes!
## License
This project is licensed under [MIT](https://opensource.org/licenses/MIT). See [LICENSE](https://github.com/yak-fumblepack/jekyll-academic/blob/master/LICENSE.txt) file for more details.Explore similar templates
Compare previews and descriptions within the same stack and category.

al-folio
A Jekyll academic homepage theme for scholars and researchers, with a clean responsive design and out-of-the-box support for publication lists, project showcases, CVs, and blogs.
Jekyll · Portfolio

minimal-mistakes
Minimal Mistakes is a two-column Jekyll theme for personal sites, blogs, project documentation, or portfolios.
Jekyll · Portfolio

Beautiful Jekyll
Beautiful Jekyll is a mature, easy-to-use Jekyll blog theme maintained by Dean Attali since 2015, with over 50,000 users.
Jekyll · Blog

jekyll-TeXt-theme
A customizable Jekyll theme for personal sites, team sites, blogs, projects, and documentation.
Jekyll · Blog

startbootstrap-clean-blog-jekyll
The official Jekyll version of Start Bootstrap's Clean Blog theme, offering a blog home page, about page, contact page, and sample post pages, with a Formspree-powered contact form.
Jekyll · Blog

So Simple
A minimal reading-oriented Jekyll theme by Michael Rose for personal blogs, portfolios, and long-form reading. It offers multiple layouts, microformat markup, Disqus comments, Google Analytics, Jekyll SEO Tag, three skins, and aggregation by year, category, and tag with a grid view.
Jekyll · Blog
