cotes2020 /jekyll-theme-chirpy

A minimal, responsive, and feature-rich Jekyll theme for technical writing.

★ 10,329⑂ 7,081👁 40⑃ 1,401● 960▤ 77
HTMLMITCreated 2019-01-12chirpy.cotes.page
Download: v7.6.0v7.6.0 ↓7.6.02026-06-20
+0
Daily
+13
Weekly
+34
Monthly
10,329
stars
7,081
forks
40
watchers
1,401
prs
960
issues
77
releases

README

Chirpy Jekyll Theme

  A minimal, responsive, and feature-rich Jekyll theme for technical writing.

  [![CI][badge-ci]][ci] 
  [![Codacy Badge][badge-codacy]][codacy] 
  [![GitHub license][badge-license]][license] 
  [![Gem Version][badge-gem]][gem] 
  [![Open in Dev Containers][badge-open-container]][open-container]

  [Live Demo →][demo]

  ![Devices Mockup][demo]



 Features

- Design & UX - Responsive layout, Dark/Light modes, Localized UI language,
  and Dark mode images.
- Content Management - Pinned posts, Hierarchical categories, Trending tags,
  Auto-generated Table of Contents, and Last modified dates.
- Rich Text Support - Syntax highlighting, Mathematical expressions, Mermaid
  diagrams & flowcharts, and Embedded media.
- Interactivity & Outreach - Built-in search, Multiple comment systems, and
  Atom feeds.
- System & Optimization - PWA support, integrated Web analytics, and
  advanced SEO performance.

 Documentation

To learn how to use, develop, and upgrade the project, please refer to the
[Wiki][wiki].

 Contributing

Contributions (_pull requests_, _issues_, and _discussions_) are what make the
open-source community such an amazing place to learn, inspire, and create. Any
contributions you make are greatly appreciated.
For details, please refer to our [Contributing Guidelines][contribute-guide].

 Credits

This project is built on the [Jekyll][jekyllrb] ecosystem and integrates a
collection of [excellent libraries][lib]. Its avatar and favicon are sourced
from [ClipartMAX][clipartmax].

Furthermore, thanks to everyone who contributed to the development of this project!

[![all-contributors][contributors-avatar]][contributors]

 License

This project is licensed under the [MIT License][license].

[badge-ci]: https://img.shields.io/github/actions/workflow/status/cotes2020/jekyll-theme-chirpy/ci.yml?logo=github
[badge-codacy]: https://img.shields.io/codacy/grade/4e556876a3c54d5e8f2d2857c4f43894?logo=codacy
[badge-license]: https://img.shields.io/github/license/cotes2020/jekyll-theme-chirpy?color=goldenrod
[badge-gem]: https://img.shields.io/gem/v/jekyll-theme-chirpy?&logo=RubyGems&logoColor=ghostwhite&label=gem&color=orange
[badge-open-container]: https://img.shields.io/badge/Dev_Containers-Open-deepskyblue?logo=linuxcontainers
[gem]: https://rubygems.org/gems/jekyll-theme-chirpy
[ci]: https://github.com/cotes2020/jekyll-theme-chirpy/actions/workflows/ci.yml?query=event%3Apush+branch%3Amaster
[codacy]: https://app.codacy.com/gh/cotes2020/jekyll-theme-chirpy/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade
[license]: https://github.com/cotes2020/jekyll-theme-chirpy/blob/master/LICENSE
[open-container]: https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/cotes2020/jekyll-theme-chirpy
[jekyllrb]: https://jekyllrb.com/
[clipartmax]: https://www.clipartmax.com/middle/m2i8b1m2K9Z5m2K9_ant-clipart-childrens-ant-cute/
[demo]: 

Top issues

Discussions

Latest release

v7.6.0 v7.6.0 2026-06-20
7.6.0 (2026-06-20)

 Features

 add edit this post link (2517) (6bd446c)
 theme: persist user theme preferences (2756) (7496dd4)
 ui: optimize design of PWA update notification (2757) (5cc9dc6)

 Bug Fixes

 giscus: synchronize theme state during lazy loading (2742) (ceb2a41)
 prevent Firefox from opening blank page on mailto links (2642) (2685b91)
 pwa: avoid iOS status bar overlapping PWA content (2173) (3823212)

 Improvements

 ui: prevent vertical flickering caused by subtitle loading (2db0535)

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON