wikigit the open reference
Contents
This site is a Wikigit, running on Wikigit. Every page you read here is an ordinary file you can open and edit.

Wikigit is a wiki engine — software for running a website that a group of people write together, one page at a time. It works the way Wikipedia taught everyone to expect: open a page, click Edit, change it, save. What makes it unusual is underneath. Every page is a plain Markdown file kept in a Git repository, not a row in a database.

::image[Wikigit inherits Wikipedia’s “anyone can edit” idea, but keeps the pages as files in Git.]{src=https://commons.wikimedia.org/wiki/Special:FilePath/Wikipedia-logo-v2.svg align=right width=150 upright}

That one decision settles most of the others. The page history is the repository’s history, so nothing is ever really lost. The content is yours, because it lives in your own GitHub account as files you can copy or move whenever you like. And there is barely anything to run: readers load pages straight from a content delivery network, and the only custom piece is one small program that saves people’s edits.1

What it is for edit

A wiki fits whenever a group needs to keep shared knowledge in one place and let many hands maintain it. A community or fan wiki, a game guide, a project’s documentation, a team handbook, a personal notebook you want to publish — all of these are collections of linked pages that change over time, which is what a wiki is.

You don’t have to be a programmer to run one. If you can copy a project on GitHub and click through a short setup, you can have a working Wikigit in a few minutes. Writing pages is closer to writing an email than to writing code.

How it works, briefly edit

The system splits in two, and the split is the whole trick.

Reading costs nothing to run. Each page is fetched from a CDN at the exact version it was last saved, so a change shows up the moment the next person opens the page. There is no build step and no waiting. Editing is the only part that needs a server, and it is a deliberately small one: a single program called the Engine that takes an edit, checks it, and writes it back to the repository as a commit.

The longer version, with both paths drawn out, is in Architecture.

Editing and who can do it edit

Anyone you allow can edit, and there are three ways a person can show up. They can stay anonymous, the way a passer-by fixes a typo on Wikipedia, in which case the edit is credited to a short nickname. They can sign in with GitHub. Or they can sign in with a Wikigit account, which needs only an email address and a one-time code. None of this is required to read, and you choose which of them may write. See Identity and accounts.

A newcomer’s edit either goes live at once or waits for a quick review, and people earn the right to publish directly as their accepted edits add up. That balance — open enough to invite help, careful enough to stay clean — is the editing model. The tools for steering it are in Trust and moderation.

What it costs edit

For an ordinary wiki, nothing. Reading runs on a free CDN. Editing goes through the Engine, which wikigit.org will host for you at no cost, or which you can run yourself on a small server. Either way a normal wiki fits comfortably within free tiers. And because the content is just files in your own account, you are never locked in, and never paying to get your own pages back.

Background edit

The design starts from a question: how much of a wiki do you actually have to build? Wikigit’s answer is “almost none of it.” History, hosting, the discussion layer, even sign-in already exist as free, dependable services. Git keeps the history. A CDN serves the reading. GitHub holds the storage and the accounts. What none of them provides is a safe way to let an anonymous visitor write to a repository without handing them the keys. That missing piece is the Engine, and the rest is glue.

Explore this wiki edit

This site documents Wikigit by being one. The pages below are the reference.

ConceptsArchitecture · Editing model · Anonymous editing · Identity and accounts · Trust and moderation · Talk pages · Categories · Links and references · Images and media · Anatomy of a page · Revision history · Multilingual wikis · Special pages

GuidesCreate your wiki · Editing pages · Formatting · Customize · Organizing · Administration · Signing in

ReferencePage settings · Site settings · Glossary · FAQ

See also edit

References edit

  1. Reading is served by the jsDelivr CDN. Editing goes through the Engine — a small Bun server that wikigit.org can host for you, or that you can run yourself behind a reverse proxy.