R.I.P.

deadwiki

deadwiki is a Markdown-powered wiki that uses your filesystem as its db. This means you can keep your wiki in a git repository and edit content with your text editor, or read and modify pages with style using its 1990s-era web interface.


There are three built-in ways to access your deadwiki:

~ status ~

Very barebones, no native app yet. Under construction!

~ getting started ~

To begin, create an empty directory or find one already populated with .md files. This is your deadwiki. Simply point the CLI utility at it to get going:

dead my-wiki-dir/
-> deadwiki serving my-wiki-dir/ at http://0.0.0.0:8000

Now visit that URL in your browser! (Or don't. It's up to you.)

You can edit wiki pages locally with something like vim, or by using the web UI. Edits show up instantly, as do new pages - there is no database and no fancy pantsy caching. Just you, your filesystem, and a dream.

In addition to [CommonMark], Markdown files can link to each other by putting the [Page Name] in brackets. Like most wikis, it'll either be a link to the actual page or a way to create it.

~ keyboard shortcuts ~

Wiki editing uses [SimpleMDE], so check out their keyboard shortcuts.

In addition, if you're in the web UI you can use these:

| Shortcut | Notes | | -------------- | -------------------------------- | | Double Click | Enters edit mode for a wiki page | | ESC | Exits edit mode | | Ctrl+Enter | Submits your edits | | Cmd+Enter | Same |

~ installation ~

Hey, how do I get that handy dandy dead CLI utility? With [cargo]:

cargo install deadwiki

Now you should be able to run dead -h to see the possibilities.