osFoundry / Platform
Notizen – Diagramme
Mermaid-Diagramme leben direkt neben ihrem Quellcode. Auf einer Seite bearbeiten, auf der anderen rendern.
Was es ist
Notes (Diagramme) ist die Mermaid-Autorenfläche innerhalb der Notes von osFoundry. Ein Mermaid-Diagramm wird als reiner Text definiert (Flussdiagramme, Sequenzdiagramme, Klassendiagramme, Zustandsautomaten, ER-Diagramme, Gantt-Diagramme), und diese Funktion hält diesen Text und sein gerendertes Bild in derselben Notiz. Du bearbeitest den Code auf der einen Seite, das Diagramm rendert auf der anderen, sodass Definition und Ergebnis nie auseinanderlaufen.
Weil das Diagramm als sein Quellcode gespeichert wird und nicht als exportiertes Bild, bleibt es Teil des Notiztextes. Du kannst es diffen, kopieren, an einen Agenten übergeben oder in eine andere Notiz einfügen, ohne die Möglichkeit zum Bearbeiten zu verlieren. Nichts wird in einen Screenshot eingeebnet, den du zum Ändern neu zeichnen müsstest. Ändere einen Pfeil im Code, und das Rendering zeigt es sofort, und genau das macht das Iterieren an einem Diagramm schnell statt mühsam.
Das Ganze steckt in osFoundry, einem Desktop-Workspace mit eigenem Schlüssel, in dem Chat, Agenten, Apps, Code und Wissen sich einen Ort teilen. Notes ist local-first, also bleibt ein Diagramm, das du skizzierst (eine Architektur, ein Prozess, ein Datenmodell), auf deinem Gerät, sofern du es nicht anders entscheidest. Und da osFoundry jedes Modell ausführt, für das du deinen eigenen Schlüssel mitbringst, kann ein Agent im Workspace den Mermaid-Code direkt in der Notiz entwerfen oder überarbeiten, und du siehst ihn in dem Moment rendern, in dem er landet.
Wichtige Funktionen
- Erstelle Mermaid-Diagramme in einer Notiz und sieh sie nebeneinander rendern: Code auf der einen, Bild auf der anderen Seite
- Änderungen am Diagrammcode rendern das Bild schon beim Tippen neu, sodass das Iterieren an einem Flow oder einer Sequenz sofort geschieht
- Diagramme werden als ihr Textquellcode gespeichert, nicht als eingebrannte Bilder, und bleiben so bearbeitbar, diffbar und kopierbar
- Unterstützt die von Mermaid abgedeckten Typen: Fluss-, Sequenz-, Klassen-, Zustands-, ER- und Gantt-Diagramme
- Local-first Notes hält deinen Diagramm-Quellcode auf deinem Gerät; Agenten, die du mit eigenem Schlüssel ausführst, können den Mermaid-Code direkt entwerfen oder überarbeiten
Anwendungsfälle
- Entwickler: dokumentiert den Request-Flow eines Dienstes als Mermaid-Sequenzdiagramm in einer Notiz und passt den Code an, während sich das Design ändert
- Technischer Redakteur: hält ein Architektur-Flussdiagramm inline mit dem erklärenden Dokument und bearbeitet den Code, statt ein Bild neu zu exportieren
- Team-Lead: skizziert einen Projektzeitplan als Gantt-Diagramm und bittet einen Workspace-Agenten, den Mermaid-Code zu aktualisieren, wenn sich Termine verschieben
Häufig gestellte Fragen
Welche Mermaid-Diagrammtypen kann ich rendern?
Den Standardsatz von Mermaid: Flussdiagramme, Sequenzdiagramme, Klassendiagramme, Zustandsdiagramme, Entity-Relationship-Diagramme und Gantt-Diagramme. Du schreibst sie in der Textsyntax von Mermaid, und die Notiz rendert sie live.
Wird das Diagramm als Bild oder als bearbeitbarer Text gespeichert?
Als Text. Der Mermaid-Quellcode liegt in der Notiz, und das Rendering wird daraus erzeugt. Das heißt, du kannst jederzeit zur Definition zurückkehren und sie bearbeiten, statt ein statisches Bild neu zu zeichnen, und der Quellcode reist beim Kopieren mit der Notiz mit.
Kann ein KI-Agent das Diagramm für mich schreiben?
Ja. osFoundry ist ein Workspace mit eigenem Schlüssel, also kann ein Agent, der auf einem von dir verbundenen Modell läuft, den Mermaid-Code innerhalb der Notiz erstellen oder überarbeiten. Da das Diagramm Quelltext ist, rendert alles, was der Agent schreibt, genauso wie deine eigenen Änderungen.