Knowledge

Knowledge is Altair’s answer to “where did I write that thing down?” — a place for markdown notes that can link to each other, surface automatic backlinks, and stay yours permanently.

This guide is a placeholder. The Knowledge domain ships in the server and clients, but the full user-facing guide hasn’t been written yet. The sections below outline what the finished guide will cover. For reference-level detail, see the Knowledge PRD on GitHub.

What’s in the domain

• Notes — markdown documents with titles, bodies, and arbitrary tags.
• Wiki-links — [[another note]] syntax that links notes together by title.
• Backlinks — the inverse of wiki-links, computed automatically. When a note is linked to, it knows.
• Snapshots — periodic captures of a note’s state so earlier versions are never lost.
• Search — full-text search across every note. Optional semantic search via pgvector if you’ve wired that up.

Workflows the full guide will cover

• Capturing a note quickly from any client.
• Using [[wiki-links]] and understanding when a link is dangling.
• Finding the things you’ve already written — search, backlinks, and tags.
• Reviewing snapshots when you want to see what a note used to say.
• Linking a note to a quest or an inventory item across domains.

In the meantime

The web and Android clients both support notes today. The shape you’ll see in the UI matches the list above — create a note, type in markdown, use [[ ]] to link, and the backlinks will appear automatically. Tags are applied with the standard #tag convention.