Diagramme, Mathematik & Einbettungen

Diagramme und Einbettungen können komplexe Abläufe verständlich machen. Sie können aber auch externe Dienste laden oder Informationen außerhalb des eigenen Docmost-Systems übertragen. Prüfen Sie deshalb vor jeder Einbettung Zweck, Freigabe und Datenfluss.

Stand: Docmost v0.95.0
Zielgruppe: Bearbeitende und Fachautorinnen/Fachautoren
Edition: Mermaid, Draw.io, Excalidraw, Mathematik und Einbettungsblöcke gehören zum Editor-Grundumfang; die konkrete Verfügbarkeit kann administrativ eingeschränkt sein
Voraussetzungen und Rechte: Bearbeitungsrecht; für externe Inhalte zusätzlich interne Datenschutz- und Freigaberegeln

Mermaid-Diagramm

Mermaid erzeugt ein Diagramm aus Textsyntax. Das eignet sich besonders für Abläufe, die leicht versioniert und angepasst werden sollen.

1. Geben Sie / ein und wählen Sie Mermaid-Diagramm.
2. Tragen Sie die Mermaid-Syntax in den Editorblock ein.
3. Prüfen Sie die automatisch aktualisierte Vorschau.
4. Kontrollieren Sie Bezeichnungen, Pfeilrichtungen und Abbruchpfade.

Beispiel für eine Störungsmeldung:

flowchart TD
  A[Störung entdeckt] --> B{Gefahr im Verzug?}
  B -->|Ja| C[Anlage sichern und Notfallweg auslösen]
  B -->|Nein| D[Störung im Ticketsystem erfassen]
  C --> E[Verantwortliche Stelle informieren]
  D --> E

Mermaid unterstützt unter anderem Ablauf-, Sequenz-, Klassen-, Zustands-, ER-, Gantt-, Kreis-, Git- und Mindmap-Diagramme.

Praxisregel: Ein Diagramm ergänzt die Arbeitsanweisung. Sicherheitsrelevante Bedingungen und Verantwortlichkeiten zusätzlich als normalen Text dokumentieren.

Draw.io

Draw.io bietet Formen, Verbinder und Layoutwerkzeuge für technische und organisatorische Diagramme.

1. Geben Sie / ein und wählen Sie Draw.io.
2. Erstellen Sie das Diagramm im geöffneten Editor.
3. Klicken Sie dort auf Speichern, um es in die Seite einzubetten.
4. Öffnen Sie das Diagramm später per Doppelklick erneut.

Geeignete Motive sind Anlagenübersichten, Prozessketten, einfache Netzpläne, Organisationsbilder oder Übergabeabläufe.

Datenschutz: Docmost verwendet für Draw.io standardmäßig einen über ein Iframe eingebundenen Draw.io-Editor. Eine selbst betriebene Installation kann einen eigenen Draw.io-Endpunkt konfigurieren. Anwender sollten keine vertraulichen Pläne einfügen, bevor die Organisation den eingesetzten Endpunkt und Datenfluss freigegeben hat.

Excalidraw

Excalidraw ist ein Whiteboard im handgezeichneten Stil:

1. / eingeben und Excalidraw wählen.
2. Formen, Pfeile, Text oder Freihandzeichnung ergänzen.
3. Mit Speichern in die Seite übernehmen.
4. Per Doppelklick erneut bearbeiten.

Nutzen Sie Excalidraw für Workshops, erste Skizzen und gemeinsame Ideen. Für eine freigegebene Anlagen- oder Prozessdokumentation ist ein sauber beschriftetes finales Diagramm meist geeigneter.

Speicherung und Bearbeitung

Docmost speichert Diagramme als SVG-Dateien. Die editierbaren Ausgangsdaten bleiben im SVG erhalten, sodass ein Diagramm später weiterbearbeitet werden kann. Mermaid und Excalidraw sind laut offizieller Dokumentation eingebaut und benötigen keinen externen Dienst.

Beim Export oder bei externer Weitergabe trotzdem prüfen, ob Diagramme vollständig enthalten und außerhalb von Docmost korrekt dargestellt werden.

Mathematik

Mit Mathematik inline und Mathematikblock rendert Docmost KaTeX-Ausdrücke. Nutzen Sie Inline-Mathematik für kurze Werte im Satz und einen Block für größere Formeln.

$$Q = A \cdot v$$

Erklären Sie Variablen und Einheiten direkt daneben. Eine Formel ohne Definition ist in einer betrieblichen Anweisung leicht misszuverstehen.

Externe Einbettungen

Das Slash-Menü bietet Einbettungen für Dienste wie YouTube, Vimeo, Figma, Miro, Airtable, Typeform, Loom, Google Drive, Google Sheets, Google Docs, Framer und allgemeine Iframes.

Vor dem Einbetten:

1. Prüfen Sie, ob der Anbieter intern freigegeben ist.
2. Verwenden Sie nur Inhalte, deren Zugriffsrechte zur Docmost-Zielgruppe passen.
3. Klären Sie, ob beim Laden IP-Adresse, Cookies oder weitere Nutzungsdaten übertragen werden.
4. Testen Sie die Ansicht mit einem Konto ohne Sonderrechte.
5. Stellen Sie eine Textalternative oder einen erklärenden Link bereit.
6. Prüfen Sie regelmäßig, ob der eingebettete Inhalt noch verfügbar und aktuell ist.

Achtung: Eine in Docmost sichtbare Einbettung übernimmt nicht automatisch die Docmost-Berechtigungen. Der externe Dienst besitzt eigene Freigaben, Konten und Protokollierungen.

Auswahlhilfe

Weiterführende Originalquellen

• Diagrams↗ (öffnet in einem neuen Tab)
• Editor↗ (öffnet in einem neuen Tab)