Yoyoyo is a Jekyll theme for GitHub Pages, distributed as a Ruby gem, that converts kramdown Markdown documents into a static website with a Tailwind CSS–based design.
What is Yoyoyo?
Yoyoyo is a Jekyll theme created by zhanghecool, built for GitHub Pages and written in kramdown Markdown. The theme takes kramdown documents as input and produces a static site, with the demo available at https://yoyoyo.zhanghe.cool/. It is installed either by cloning the GitHub repository or by installing the yoyoyo gem from RubyGems.
Key Features
- Jekyll integration — Built on the Jekyll static site generator, so it outputs plain HTML ready for GitHub Pages.
- kramdown support — Content is authored in kramdown, a superset of Markdown, giving you more control over the generated HTML.
- Tailwind CSS and PostCSS — The theme's styling is generated with Tailwind CSS and processed through PostCSS, as indicated by the project's tags.
- RubyGem distribution — Install with
gem install yoyoyoor addgem 'yoyoyo', '~> 0.0.9'to your Gemfile; the current version is 0.0.9. - GitHub Pages ready — The theme is designed to be served from GitHub Pages; the example site runs at yoyoyo.zhanghe.cool.
- Image CDN guidance — The README recommends using your own CDN or jsDelivr's GitHub image acceleration to load images.
Who is Yoyoyo for?
Yoyoyo is for Jekyll users who want a lightweight, Tailwind-styled theme for a personal blog or project site. It also suits developers who prefer writing in kramdown and hosting on GitHub Pages, and those who want a theme they can install as a Ruby gem.
How does Yoyoyo work?
To get started, either clone the repository with git clone https://github.com/zhanghecool/yoyoyo.git or install the gem with gem install yoyoyo. For a Bundler setup, add gem 'yoyoyo', '~> 0.0.9' to the Gemfile. The repository's wiki provides a Getting started page that explains the framework contents, templates, and examples.
Pricing
Yoyoyo is a free, open-source theme distributed through RubyGems; there are no paid tiers mentioned.
FAQ
Is Yoyoyo free?
Yes, Yoyoyo is an open-source Jekyll theme. It is distributed as a Ruby gem on RubyGems, and you can also clone the repository from GitHub. No paid plan or premium tier is mentioned in the project documentation.
How do I install Yoyoyo?
You can install it via RubyGems with gem install yoyoyo, or add gem 'yoyoyo', '~> 0.0.9' to your Gemfile. Alternatively, clone the repository with git clone https://github.com/zhanghecool/yoyoyo.git and follow the wiki's Getting started guide.
Does Yoyoyo work with GitHub Pages?
Yes, the theme is built for GitHub Pages and the example site runs at https://yoyoyo.zhanghe.cool/. Because it is a Jekyll theme, you can deploy it directly on GitHub Pages by pushing your Jekyll site to a repository configured for Pages.
How can I speed up image delivery?
The theme's README suggests using your own CDN service for images, or using jsDelivr's GitHub acceleration with the format https://cdn.jsdelivr.net/gh/GitHub用户名/仓库名@版本号/文件路径 to serve files from your repository.




