An Otter Wiki

MIT
Platform
Docker Web
Licence
MIT Open source
An Otter Wiki

An Otter Wiki is a minimalistic wiki built on Python and Flask, storing every page as Markdown inside a git repository. There is no database behind it: the git history is the revision history, so every edit, author and revert is already recorded and browsable. It suits team documentation, a personal knowledge base or a project handbook that you want to keep as plain text you own.

Editing and Markdown

  • A CodeMirror editor with Markdown syntax highlighting and a live preview; tables are supported directly in the editor.
  • Extended Markdown beyond the basics: tables, footnotes, fancy blocks, alerts and Mermaid diagrams.
  • Page attachments for files and images, plus emoji and full UTF-8 support.
  • Full page history and changelog, read straight from the git commits that back the wiki.

Navigation and access

  • A collapsible sidebar you can configure as a hand-written menu, an automatically generated page index, or both.
  • A clean reading interface with a dark mode, breadcrumbs and an “On this page” table of contents.
  • User authentication with the first registered account acting as administrator, so it can be opened to a team or kept private.
  • Site-wide search over page titles and content.

Deployment

  • Distributed as the redimp/otterwiki Docker image; the documented setup is a short docker-compose.yml with a single volume mounted at /app-data.
  • Because all content is plain Markdown in git, pages can be backed up, diffed or migrated with ordinary git commands — no export step.
  • An experimental built-in git HTTP server lets you clone, pull and push the wiki content from a normal git client.
  • MIT licensed, actively developed, and installed behind any reverse proxy (nginx, Apache or Caddy examples are in the documentation).

Alternatives

  • Pepperminty Wiki — a single-file PHP wiki with Markdown pages and no database.
  • Raneto — a Markdown knowledge base for Node.js that builds its pages from files on disk.

Explore More Categories

Sign In

Register

Reset Password

Please enter your username or email address, you will receive a link to create a new password via email.