Dokumentformat – deine Daten gehören dir

Jede Zeichnung in AnnexShow lässt sich als offene, dokumentierte Datei herunterladen und wieder einlesen. Kein Lock-in: das Format ist beschrieben, versioniert und maschinenlesbar spezifiziert.

Zwei Formate

Format	Endung	Wofür
AnnexShow-Dokument	`.annexshow.json`	Reines JSON, verlustfrei, per JSON-Schema beschrieben. Der Weg für eigene Werkzeuge und Skripte.
Annex-Dokument	`.axd`	ZIP-Container der AnnexCreativeLab-Suite. Enthält zusätzlich eine Vorschau und das native Dokument — dadurch verlustfrei auf dem Rückweg.

Herunterladen und öffnen

Im Editor über Exportieren das gewünschte Dokumentformat wählen; Öffnen liest eine Datei wieder ein. Über die API geht beides ebenso:

GET /api/v1/canvases/{canvas}/document GET /api/v1/canvases/{canvas}/document?format=axd POST /api/v1/projects/{project}/canvases/import (multipart, Feld "file")

Aufbau der Datei

Der Umschlag nennt Typ, Fassung, Schema und Herkunft; darunter liegt das Dokument unverändert so, wie AnnexShow es speichert.

{ "type": "annexshow-document", "version": 1, "$schema": "https://annexshow.com/schema/annexshow-document-v1.json", "source": "https://annexshow.com", "canvas": { "title": "Mein Diagramm", "width": 1920, "height": 1080 }, "document": { "version": 1, "width": 1920, "height": 1080, "layers": [ { "id": "layer-1", "name": "Ebene 1", "type": "svg", "visible": true, "objects": [ { "id": "rect-1", "type": "rect", "transform": { "x": 100, "y": 80 }, "size": { "width": 240, "height": 120 }, "style": { "fill": { "color": "#2563eb" } } } ] } ] } }

Grundregeln

Ebenen und Objekte: Ein Dokument hat Ebenen, jede Ebene hat Objekte. Gruppen tragen ihre Kinder in children, deren Koordinaten relativ zur Gruppe liegen.
Koordinaten: transform.x/y ist die linke obere Ecke in Pixeln, rotation sind Grad im Uhrzeigersinn um den Objektmittelpunkt.
Punkte: points liegt lokal zum Objektursprung — außer bei line und arrow, die ihre Punkte im Dokumentraum tragen.
Kurven: Beim Typ pen sind points die Ankerpunkte und handles die Kontrollpunkte je Anker. Fehlt ein Handle, wird die Tangente aus den Nachbarpunkten abgeleitet; auf (0,0) gesetzte Kontrollpunkte machen den Anker zur Ecke.
Verbindungen: Ein connector speichert keine Koordinaten, sondern die IDs der verbundenen Objekte. Die Linie entsteht beim Zeichnen aus deren Lage — deshalb bleibt sie beim Verschieben verbunden.

Fassungen

version im Umschlag beschreibt den Umschlag, nicht den Inhalt. Sie wird nur erhöht, wenn sich die Struktur so ändert, dass ältere Leser scheitern würden. Eine Datei aus einer neueren Fassung wird beim Import ausdrücklich abgelehnt statt halb gelesen. Dateien ohne Umschlag — etwa aus einem Backup — werden ebenfalls angenommen.

Maschinenlesbare Spezifikation

Das vollständige JSON-Schema (Draft 2020-12) liegt offen:

https://annexshow.com/schema/annexshow-document-v1.json

Elementsammlungen

Neben Dokumenten lassen sich auch Bibliotheks-Sammlungen mitnehmen: .annexshowlib ist unser offenes Sammlungsformat, und .excalidrawlib-Dateien aus dem Excalidraw-Ökosystem lassen sich direkt importieren. Beides über den Import-Knopf im Bibliothek-Panel.

Warum uns das wichtig ist. Ein Werkzeug, aus dem man seine Arbeit nicht herausbekommt, ist eine Falle. Das Format ist deshalb offen dokumentiert und der Export verlustfrei — auch dann, wenn jemand AnnexShow wieder verlassen möchte.