This is a demo of git-wiki theme for jekyll

Edit Edit with History Source

Welcome to git-wiki demo

This is a demo of git-wiki theme for jekyll.

it’s a full featured wiki powered by git, github pages and pull-requests!

It means:

  • Improvements in the cooperative aspect: forks, pull-requests and roles.
  • You can customize your wiki as you want with style sheets and even changing the layout.
  • No databases! Only static files that can be downloaded in a few seconds.
  • Markdown and html mixed together!
  • History, revision comparison and everything you need from a wiki platform.
  • You can edit your pages with the standard git editor, (integrated) or any kind of editor you prefer.
  • Non-existent wiki page links are “red

You can fork/copy the master branch now and start your wiki in just 1 minute.

Note: You can even include the official github wiki as a submodule and enable the option in our conf file to use github wiki pages in git-wiki system, but it’s an experimental feature and it implies less advantages and greater disadvantages for now.

Who is using git-wiki

List of git-wiki installations

List of forked repository

Installation instructions

  1. Fork or copy this repository

  2. copy and rename _config.yml.dist in _config.yml changing settings inside

  3. create your in root directory

  4. push your changes in your repository, then configure the github pages in your repository settings

  5. Your wiki is ready!


We suggest the creation of a /wiki/ subfolder that collects all your .md pages (except

Current known limitations

  • You can’t use the wiki internal link format: [[example]]. Please, use gh-pages links instead: [example](example) . It’s a known jekyll limitation:


You can create following files in _includes folder to costumize git-wiki without patching original code:

  • head.html -> this file will be included in <head> tag allowing you to add css/js and any kind of head tags
  • sidebar.html -> this file will be included in left sidebar allowing you to create your widgets
  • comments.html -> this is mostly used to integrate social comments under page contents
  • footer.html -> this file will be included in left side of the footer.

Looking for collaboration

Do you like this project? then, contact us via chat , email or send us a PR to improve it.

Thank you!

Components used