Skip to content
a flask based wiki, using markdown files as backend. completely file based!
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
tests fix wiki index test. Nov 20, 2016
wiki update to address review Mar 30, 2018
.gitignore ignore dist directory. Nov 19, 2016
.travis.yml patch tests fixed branch Feb 19, 2018
LICENSE Add a license (fixes #34) Jul 19, 2013 Correctly include static files (fixes #68). Feb 27, 2017 Add gitter chat badge Nov 21, 2016
appveyor.yml patch appveyor Mar 30, 2018
setup.cfg switch to Nov 19, 2016 Correctly include static files (fixes #68). Feb 27, 2017


Linux build status Windows build status Join the chat at


As I wanted a wiki that just uses plain markdown files as backend, that is easy to use and that is written in python, to enable me to easily hack around, but found nothing, I just wrote this down. I hope that it might help others ,too.


  • Markdown Syntax Editing
  • Tags
  • Regex Search
  • Random URLs
  • Web Editor
  • Pages can also be edited manually, possible uses are:
    • use the cli
    • use your favorite editor
    • sync with dropbox
    • and many more


  • Re-introduce support for customizing the theme
  • Speed Improvements
    • Code Optimizations
    • Caching
  • Settings via the webinterface
  • Python2 & 3 compatibility.


You can install wiki using:

pip install wiki2

Afterwards you can create or change into your content directory and create a file in it, that contains at least the following:

# encoding: <your encoding (probably utf-8)
SECRET_KEY='a unique and long key'
TITLE='Wiki' # Title Optional


Afterwards you can just run wiki web in your content directory to start the server.


If you plan on helping with the development of this project you can clone the repository, open the newly created directory in a terminal and run pip install -e ., after which both the tests and the wiki cli will be available to you.


Thank you very much to my two top contributers @walkerh and @traeblain. You two have posted so many issues and especially solved them with so many pull requests, that I sometimes lose track of it! :)

You can’t perform that action at this time.