Basalt-Dokumentation

Basalt ist ein Wissens-Arbeitsplatz: Dokumente aus Blöcken, typisierte Datenbanken mit Ansichten, Zusammenarbeit in Echtzeit — Markdown als Ablage, Schnittstelle zuerst, gehostet von uns.

Der Gedanke dahinter: Jeder Block hat genau einen Ort, an dem er zu Hause ist, und lässt sich überall sonst einbinden — lebendig und bearbeitbar. Ein Sachverhalt, beliebig viele Verweise.

Benutzen

Sechs Anleitungen, in der Reihenfolge, in der sie sich lohnen:

• Blöcke, der Editor und die Tastatur — worin Sie schreiben, was / anbietet, welches Markdown am Zeilenanfang wirkt und jeder Tastengriff, der belegt ist.
• Verweise, Links und Rückverweise — eine Seite verlinken, eine einbetten, auf einen einzelnen Block zeigen — und was daraus wird, wenn das Ziel umbenannt wird, im Papierkorb landet oder Ihnen verschlossen ist.
• Datenbanken, Ansichten und Zeilen — eine typisierte Tabelle, deren Zeilen Seiten sind, die gespeicherten Sichten darauf und der Unterschied zwischen „aus der Tabelle nehmen“ und „die Seite löschen“.
• Freigeben, Kommentare und Verlauf — wer eine Seite öffnen darf und woher dieser Zugriff kommt, was Leute daraufschreiben, woran sich die Seite erinnert, und der Papierkorb.
• Der Workspace und seine Einstellungen — Mitglieder, Gäste, Gruppen, Einladungen, Symbole, Export, Zugriffstoken, Webhooks und was jeder Tarif erlaubt.
• Import — wie ein Notion-Export oder ein Markdown-Ordner hereinkommt, und was der Umzug kostet.

Darauf aufbauen

• API — Authentifizierung, Zugriffstoken, Fehler, seitenweise Abfrage, Webhooks und Seiten als Markdown.
• API-Referenz — jeder Endpunkt, erzeugt aus dem OpenAPI-Dokument, das der Server selbst schreibt.
• Markdown-Spezifikation — der kanonische Dialekt, in den jede Seite geschrieben und aus dem sie verlustfrei zurückgelesen wird.
• MCP-Server — der hauseigene Model-Context-Protocol-Server für KI-Assistenten.

Den Betrieb übernehmen wir, nicht Sie. Basalt ist gehostet: nichts zu installieren, keine Datenbank zu sichern, kein Wartungsfenster auszusitzen. Ihnen gehören die Inhalte — jede Seite lässt sich über die Schnittstelle als schlichtes Markdown lesen und schreiben. Ein Auszug ist deshalb eine Schleife über GET, keine Verhandlung.

Ein Konto, ein Satz Workspaces — aber jede App wird je Workspace eingeschaltet. Ein Workspace, den Sie in einer anderen unserer Apps benutzen, taucht hier erst auf, wenn jemand mit Verwaltungsrechten Basalt dafür einschaltet; bis dahin sagt Basalt genau das und bietet den Knopf dazu an, statt Ihnen einen Workspace anlegen zu lassen, den Sie schon haben.

Wie weit ist das?

Vor 1.0 und in Bewegung. Was die Anleitungen oben beschreiben, ist das, was das Produkt heute tut; und wo eine Seite etwas beschreibt, das noch nicht geht, steht das auf der Seite — statt dass Sie es selbst herausfinden. Jede endet mit einer offenen Liste dessen, was sie noch nicht kann. E-Mail gibt es auch: Einladungen, Passwort-Zurücksetzung und die Bestätigung einer Registrierung werden zugestellt, nicht bloß versprochen.

Die Anleitungen sind jünger als das Produkt, und zwei Themen fehlen noch. Die Seitenleiste — Sammlungen, der Seitenbaum, Favoriten und das Finden einer Seite — ist nur dort beschrieben, wo eine andere Anleitung sie brauchte, das meiste davon unter Freigeben, Kommentare und Verlauf. Und Felder haben keine eigene Seite: Was eine Spalte einer Datenbank ist, steht unter Datenbanken, Ansichten und Zeilen, und das Feldverzeichnis des Workspace wird genannt, aber nicht erklärt.

In einer anderen Sprache

Jede Seite dieser Dokumentation gibt es auf Deutsch und auf Englisch; die Umschaltung sitzt oben in der Kopfzeile. Eine Ausnahme ist gewollt: die API-Referenz. Ihre Endpunktbeschreibungen kommen unverändert aus der Routentabelle des Servers und bleiben in beiden Sprachen englisch — eine übersetzte Zweitfassung liefe beim ersten Routen-Umbau auseinander.