An Otter Wiki
MIT
- Platform
- Docker Web
- Licence
- MIT Open source
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.
Views: 1