cotes2020 /jekyll-theme-chirpy
A minimal, responsive, and feature-rich Jekyll theme for technical writing.
★ 10,329⑂ 7,081👁 40⑃ 1,401● 960▤ 77
+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
#1531Add a newsletter form9 comments · 2024-02-08#1523Image Comparison Slider6 comments · 2024-02-02#2639Site generation duplicates baseurl for img when baseurl not empty4 comments · 2026-01-09#2596Lightbox not working with a thumbnail3 comments · 2025-11-19#1928RTL Support for Chirpy Theme3 comments · 2024-08-28#2807dev container post-create.sh fails to run due to permission errors2 comments · 2026-10-24#2786CSS/JS does not get updated when updating via "New content available" banner2 comments · 2026-08-17#2705Add support for Rybbit analytics2 comments · 2026-03-30
Discussions
#2797Sidebar buttons no longer aligned (multiple rows)1 comments · 2026-09-08#2792The link provided in jekylltemplates.com is broken.1 comments · 2026-08-23#2781Improve Korean line-breaking readability with `word-break: keep-all` on `.content`0 comments · 2026-07-30#2760waline评论区使用问题1 comments · 2026-06-25#2741How do i change the font of the theme?1 comments · 2026-05-16#2739Feature Request: Share to AI + Open Raw Markdown + Copy as Markdown0 comments · 2026-05-14#2733Add a Newsletter Subscribe Feature to Chirpy with Brevo0 comments · 2026-04-27#2732Chirpy’s home on Mobile0 comments · 2026-04-27
Latest release
v7.6.0 v7.6.0 2026-06-207.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)