Markdown-Editor

Der Markdown-Editor von Sutram ermöglicht es Ihnen, formatierte Textdokumente direkt im Browser zu erstellen und zu bearbeiten. Es ist ein visueller Editor (WYSIWYG), bei dem Sie das Endergebnis sehen, während Sie bearbeiten, ohne die Markdown-Syntax kennen zu müssen.

Eine Markdown-Datei erstellen

1. Navigieren Sie zu einem Ordner in Ihrem Projekt
2. Klicken Sie auf das Menü ⋮ (drei Punkte) in der oberen rechten Ecke
3. Wählen Sie Markdown-Datei hinzufügen
4. Geben Sie einen Namen für die Datei ein
5. Der Editor öffnet sich automatisch mit dem bereits eingefügten Titel

Hinweis: Diese Option erscheint nur innerhalb von Ordnern (nicht im Projektstamm) und erfordert einen PRO-Plan oder höher.

Eine bestehende Datei bearbeiten

1. Klicken Sie auf eine beliebige .md-Datei in der Inhaltsliste
2. Klicken Sie in der Ansicht auf die Schaltfläche Bearbeiten oder auf das Erweitern-Symbol
3. Der Editor öffnet sich mit dem aktuellen Inhalt der Datei

Wichtig: Zum Bearbeiten müssen Sie die Datei "auschecken". Dadurch wird die Datei für Sie reserviert und verhindert, dass andere Personen gleichzeitig bearbeiten.

Werkzeugleiste

Die Werkzeugleiste befindet sich oben im Editor. Jede Schaltfläche wendet eine bestimmte Formatierung an.

Textformatierung

Schaltfläche	Name	Verhalten
B	Fett	Umschalten - Einmal klicken zum Aktivieren, erneut klicken zum Deaktivieren. Funktioniert mit markiertem Text oder an der aktuellen Cursorposition. Tastenkürzel: Ctrl+B (Windows) oder Cmd+B (Mac)
I	Kursiv	Umschalten - Funktioniert wie Fett. Tastenkürzel: Ctrl+I oder Cmd+I
S	Durchgestrichen	Umschalten - Fügt eine Linie über dem markierten Text hinzu oder entfernt sie
<>	Inline-Code	Umschalten - Formatiert den Text als Code (Monospace-Schrift)

Überschriften

Schaltfläche	Name	Verhalten
H1	Überschrift 1	Umschalten - Wandelt die aktuelle Zeile in eine große Überschrift um. Wenn bereits H1, wird es wieder ein normaler Absatz
H2	Überschrift 2	Umschalten - Mittlere Überschrift. Wenn bereits H2, wird es wieder ein Absatz
H3	Überschrift 3	Umschalten - Kleine Überschrift. Wenn bereits H3, wird es wieder ein Absatz

Tipp: Positionieren Sie den Cursor in einer beliebigen Zeile und klicken Sie auf H1, H2 oder H3, um sie in eine Überschrift umzuwandeln.

Listen

Schaltfläche	Name	Verhalten
•	Aufzählungsliste	Umschalten - Erstellt eine Liste mit Aufzählungszeichen. Erneut klicken, um zum Absatz zurückzukehren
1.	Nummerierte Liste	Umschalten - Erstellt eine automatisch nummerierte Liste

Unterelemente erstellen: Drücken Sie innerhalb einer Liste Tab, um ein Unterelement zu erstellen (einrücken) oder Shift+Tab, um zur vorherigen Ebene zurückzukehren.

Spezielle Blöcke

Schaltfläche	Name	Verhalten
"	Zitat	Umschalten - Erstellt einen Zitatblock (mit seitlicher Leiste). Nützlich um wichtige Textpassagen hervorzuheben
[ ]	Codeblock	Einfügen - Erstellt einen Bereich für Code mit mehreren Zeilen

Tabellen

Die Tabellenschaltfläche (Rastersymbol) öffnet ein Dropdown-Menü mit allen Optionen zum Erstellen und Bearbeiten von Tabellen.

Option	Verhalten
Tabelle einfügen	Erstellt eine 3x3-Tabelle an der Cursorposition
Zeile oben hinzufügen	Fügt eine neue Zeile oberhalb der aktuellen Zeile ein
Zeile unten hinzufügen	Fügt eine neue Zeile unterhalb der aktuellen Zeile ein
Spalte links hinzufügen	Fügt eine neue Spalte links neben der aktuellen Spalte ein
Spalte rechts hinzufügen	Fügt eine neue Spalte rechts neben der aktuellen Spalte ein
Zeile löschen	Entfernt die Zeile, in der sich der Cursor befindet
Spalte löschen	Entfernt die Spalte, in der sich der Cursor befindet
Tabelle löschen	Entfernt die gesamte Tabelle

Tabellen verwenden:

1. Tabelle erstellen: Klicken Sie auf die Tabellenschaltfläche und wählen Sie "Tabelle einfügen". Eine 3x3-Tabelle wird erstellt.

2. Zellen bearbeiten: Klicken Sie auf eine beliebige Zelle und geben Sie den Inhalt ein. Verwenden Sie Tab, um zur nächsten Zelle zu wechseln, oder Shift+Tab, um zurückzugehen.

3. Zeilen/Spalten hinzufügen: Positionieren Sie den Cursor in der Referenzzelle, klicken Sie auf die Tabellenschaltfläche und wählen Sie, wo hinzugefügt werden soll (oben, unten, links oder rechts).

4. Zeilen/Spalten löschen: Positionieren Sie den Cursor in der Zeile oder Spalte, die Sie entfernen möchten, klicken Sie auf die Tabellenschaltfläche und wählen Sie "Zeile löschen" oder "Spalte löschen".

5. Gesamte Tabelle löschen: Mit dem Cursor in einer beliebigen Zelle der Tabelle klicken Sie auf die Tabellenschaltfläche und wählen Sie "Tabelle löschen".

Tipp: Die erste Zeile der Tabelle wird automatisch als Kopfzeile formatiert (fetter Text mit hervorgehobenem Hintergrund).

Links und Medien

Schaltfläche	Name	Verhalten
(Globus)	Externer Link	Einfügen - Öffnet ein Feld zur Eingabe einer URL. Erstellt einen klickbaren Link im Text
(Kette)	Projekt-Web-Link	Auswahl - Zeigt die in dem aktuellen Ordner gespeicherten Web-Links zur Auswahl
(Landschaft)	Bild von URL	Einfügen - Öffnet ein Feld zum Einfügen einer Bildadresse aus dem Internet
(Ordner)	Projektbild	Auswahl - Zeigt die Bilder des aktuellen Ordners zur Auswahl und zum Einfügen
(Video)	Projektvideo	Auswahl - Zeigt die Video-Links des aktuellen Ordners (YouTube, Vimeo usw.)
(Audio)	Projektaudio	Auswahl - Zeigt die Audio-Links des aktuellen Ordners (SoundCloud, Spotify usw.)

Links und Medien einfügen

Externer Link (beliebige URL):

1. Markieren Sie den Text, der zum Link werden soll (optional)
2. Klicken Sie auf die Globus-Schaltfläche
3. Geben Sie die URL ein oder fügen Sie sie ein
4. Wenn Sie keinen Text markiert haben, geben Sie den Linktext ein

Projekt-Web-Link:

1. Klicken Sie auf die Ketten-Schaltfläche
2. Eine Liste zeigt die im Ordner gespeicherten Links
3. Klicken Sie auf den gewünschten Link zum Einfügen

Projektbild:

1. Klicken Sie auf die Ordner-Schaltfläche mit Bild
2. Eine Liste zeigt die Bilder des Ordners
3. Klicken Sie auf das gewünschte Bild zum Einfügen

Video oder Audio:

1. Klicken Sie auf die Video- oder Audio-Schaltfläche
2. Wählen Sie aus der Liste der Ordnermedien
3. Der Link wird in das Dokument eingefügt

Links und Medien entfernen

Um einen eingefügten Link, ein Bild, Video oder Audio zu entfernen:

1. Positionieren Sie den Cursor am Ende des Links/Mediums
2. Drücken Sie Backspace (oder Entf), um zeichenweise zu löschen
3. Oder markieren Sie das gesamte Element (klicken und ziehen) und drücken Sie Entf oder Backspace

Tipp: Bei Textlinks können Sie auch den Linktext markieren und einfach etwas Neues eingeben, um ihn zu ersetzen.

Automatisches Speichern

Der Editor speichert Ihre Arbeit automatisch alle 60 Sekunden, sofern nicht gespeicherte Änderungen vorhanden sind. Sie sehen kurz einen "Wird gespeichert..."-Indikator, wenn dies geschieht.

Wichtig: Das automatische Speichern speichert einen Entwurf. Damit andere Personen Ihre Änderungen sehen können, müssen Sie die Datei veröffentlichen.

Änderungen veröffentlichen

Wenn Sie mit der Bearbeitung fertig sind:

1. Klicken Sie auf die Schaltfläche Bearbeitung abschließen (obere rechte Ecke)
2. Die Datei wird veröffentlicht und für andere Benutzer freigegeben
3. Ihre Änderungen werden für das gesamte Team sichtbar

Hinweis: Wenn Sie den Editor verlassen, ohne die Bearbeitung abzuschließen, bleiben Ihre Änderungen als Entwurf gespeichert, aber die Datei bleibt für Sie reserviert (ausgecheckt).

KI-Assistent für Abschnitte

Der Editor enthält einen KI-Assistenten, der helfen kann, Abschnitte Ihres Dokuments zu verbessern, zusammenzufassen oder zu erweitern. Die KI-Aktionen sind in jeder Überschrift (H1, H2, H3 usw.) verfügbar.

Zugriff

Es gibt zwei Möglichkeiten, auf die KI-Aktionen zuzugreifen:

1. Rechtsklick auf eine Überschrift: Ein Kontextmenü erscheint mit den verfügbaren Optionen
2. Schaltfläche an der Überschrift: Wenn Sie mit der Maus über eine Überschrift fahren, erscheint rechts eine ⋮-Schaltfläche. Klicken Sie darauf, um die Optionen zu sehen

Verfügbare Aktionen

Aktion	Beschreibung
Abschnitt zusammenfassen	Verdichtet den Inhalt des Abschnitts und behält die Hauptpunkte bei
Abschnitt erweitern	Fügt mehr Details und Tiefe zum bestehenden Inhalt hinzu
Abschnitt verbessern	Verbessert die Schreibqualität (Klarheit, Flüssigkeit, Grammatik)
Executive Summary erstellen	Erstellt eine Zusammenfassung auf hoher Ebene des Dokuments (nur bei H1-Überschriften verfügbar)
Abschnitt löschen	Entfernt den Abschnitt und seinen gesamten Inhalt (verwendet keine KI)

Arbeitsablauf

1. Wählen Sie eine Aktion: Rechtsklick auf die Überschrift oder verwenden Sie die ⋮-Schaltfläche und wählen Sie die gewünschte Aktion
2. Warten Sie auf die Verarbeitung: Ein Ladeindikator erscheint, während die KI verarbeitet. Sie können jederzeit abbrechen
3. Überprüfen Sie das Ergebnis: Ein Vergleichspanel zeigt den Originaltext (links) und den KI-Vorschlag (rechts) nebeneinander
4. Entscheiden Sie: Klicken Sie auf Anwenden, um den Vorschlag zu akzeptieren, oder Abbrechen, um ihn zu verwerfen

Es wird keine Änderung ohne Ihre Zustimmung vorgenommen. Sie sehen das Ergebnis immer vor dem Anwenden.

Executive Summary (TLDR)

Die Aktion "Executive Summary erstellen" funktioniert anders als die anderen:

• Nur bei H1-Überschriften verfügbar
• Anstatt den Inhalt zu ersetzen, fügt sie einen neuen Abschnitt direkt unter dem H1 ein
• Der Abschnittstitel wird in der Sprache des Dokuments lokalisiert (z.B. "Executive Summary (TLDR)" auf Deutsch)

Abschnitt löschen

Das Löschen eines Abschnitts verwendet keine KI und funktioniert wie folgt:

1. Ein Bestätigungsfenster zeigt den Inhalt, der entfernt wird
2. Klicken Sie auf Abschnitt löschen, um zu bestätigen, oder Abbrechen, um beizubehalten

Achtung: Das Löschen entfernt den gesamten Abschnitt (Überschrift und gesamten Inhalt bis zur nächsten Überschrift). Diese Aktion kann nicht direkt rückgängig gemacht werden — verwenden Sie die Schaltfläche Rückgängig (vorherige Version), um das Dokument wiederherzustellen.

---

Schaltfläche Rückgängig (Vorherige Version)

Die Schaltfläche Rückgängig erscheint, wenn eine vorherige Version der Datei existiert. Ein Klick darauf:

1. Stellt die vorherige vollständige Version der Datei wieder her
2. Die aktuelle Version wird zum neuen Backup

Achtung: Dieses Rückgängigmachen stellt die gesamte Datei auf die vorherige Version wieder her, nicht nur die letzte Eingabe. Um kürzliche Eingaben rückgängig zu machen, verwenden Sie Ctrl+Z (Windows) oder Cmd+Z (Mac).

Datei herunterladen

Klicken Sie in der Inhaltsliste auf das Menü ⋮ der Markdown-Datei, um die Optionen zu sehen:

• Herunterladen: Lädt nur die .md-Datei herunter
• Mit Bildern herunterladen: Lädt eine ZIP-Datei mit dem Markdown und allen Sutram-Bildern aus dem Dokument herunter. Die Bildlinks werden in relative Pfade konvertiert, wodurch das Paket portabel wird.

Hinweis: Die Option "Mit Bildern herunterladen" erscheint nur bei veröffentlichten Dateien. Wenn keine Sutram-Bilder im Dokument vorhanden sind, wird eine Nachricht angezeigt, dass Sie die normale Download-Option verwenden sollten.

Tastenkürzel

Kürzel	Aktion
Ctrl/Cmd + Z	Letzte Eingabe rückgängig machen
Ctrl/Cmd + Shift + Z	Wiederherstellen
Ctrl/Cmd + B	Fett
Ctrl/Cmd + I	Kursiv
Enter	Neuer Absatz
Shift + Enter	Zeilenumbruch (gleicher Absatz)
Tab	Listenelement einrücken
Shift + Tab	Einrückung des Listenelements entfernen

Kommentarmodus

Der Markdown-Editor enthält einen integrierten Kommentarmodus, mit dem Sie Kommentarmarker anzeigen, verwalten und neu positionieren können, während Sie das Dokument bearbeiten.

Zwei Betriebsmodi

Der Editor wechselt zwischen zwei Modi:

Modus	Beschreibung
Bearbeitung (Standard)	Normaler Milkdown WYSIWYG-Editor, keine sichtbaren Marker
Kommentare	Gerenderte Vorschau mit Kommentar-Overlay und Seitenpanel

Zugang zum Kommentarmodus

1. Klicken Sie im Editor auf die Schaltfläche Kommentare in der Kopfzeile (neben der "Absenden"-Schaltfläche)
2. Das Badge zeigt die Anzahl der bestehenden Kommentare (z.B. "8")
3. Der Editor wechselt in den Ansichtsmodus mit sichtbaren Markern
4. Um zum Bearbeitungsmodus zurückzukehren, klicken Sie erneut auf die Schaltfläche Kommentare

Einschränkung: Der Kommentarmodus ist auf kleinen Mobilgeräten nicht verfügbar (Viewport < 768px). Er funktioniert auf Tablets (iPad, Android) und Desktops. Ein Tooltip auf der deaktivierten Schaltfläche erklärt: "Verwenden Sie einen Desktop-Computer, um Kommentare zu verwalten".

Layout des Kommentarmodus

┌─────────────────────────────────────────────────────────────────┐
│  ← Zurück         [💬 Kommentare 8]    [Absenden]    │ Kopfzeile │
├─────────────────────────────────────┬───────────────────────────┤
│                                     │ 💬 3 Kommentare           │
│   Markdown-Vorschau                 │ ─────────────────────────│
│   (schreibgeschützt)                │ ◉ Alle ○ Offen ○ Gelöst  │
│                                     │ ─────────────────────────│
│        📍 Marker 1                  │ [1] Hans · vor 2h         │
│                                     │     Diesen Abschnitt prüfen│
│        📍 Marker 2                  │     "Textauszug..."       │
│                                     │     [Gehe zu]             │
│                                     │ ─────────────────────────│
│                                     │ [2] Maria · vor 1T   ✅   │
│                                     │     Korrigiert            │
└─────────────────────────────────────┴───────────────────────────┘

Funktionen des Kommentarpanels

Das rechte Seitenpanel bietet:

Funktionalität	Beschreibung
Filter	Alle / Offen / Gelöst
Kommentarliste	Alle Kommentare des Dokuments mit Autor, Datum und Vorschau des markierten Textes
Gehe zu	Scrollt die Ansicht zum entsprechenden Marker
Strang öffnen	Klicken Sie auf den Kommentar, um Antworten zu sehen und zu interagieren

Kommentare lösen

Im Kommentarmodus können Sie Diskussionen direkt lösen:

1. Klicken Sie auf einen Kommentar im Panel oder auf den Marker im Dokument
2. Der Strang-Dialog öffnet sich mit dem ursprünglichen Kommentar und Antworten
3. Klicken Sie auf "Als gelöst markieren", um anzuzeigen, dass die Frage bearbeitet wurde
4. Der Marker wechselt von violett (offen) zu grün (gelöst)
5. Der Kommentar kann über den Tab "Gelöst" gefiltert werden

Um einen gelösten Kommentar wieder zu öffnen, öffnen Sie den Strang und klicken Sie auf "Wieder öffnen".

Unterschied zwischen Betrachter und Editor

Aspekt	Betrachter (Vorschau-Dialog)	Editor (Kommentarmodus)
Kommentare erstellen	Ja - Text markieren zum Kommentieren	Nicht verfügbar
Kommentare anzeigen	Ja - Marker sichtbar	Ja - Marker sichtbar
Lösen/Antworten	Ja - Über Strang-Dialog	Ja - Über Strang-Dialog
Inhalt bearbeiten	Nein - Schreibgeschützt	Ja - Im Bearbeitungsmodus

Empfohlener Arbeitsablauf:

1. Betrachter: Verwenden Sie ihn, um neue Kommentare zu erstellen (Text markieren)
2. Editor - Bearbeitungsmodus: Verwenden Sie ihn, um den Markdown-Inhalt zu bearbeiten
3. Editor - Kommentarmodus: Verwenden Sie ihn, um bestehende Kommentare zu überprüfen und zu lösen

---

Nützliche Tipps

1. Mit Überschriften organisieren: Verwenden Sie H1 für den Haupttitel, H2 für Abschnitte und H3 für Unterabschnitte. Das erleichtert das Lesen.

2. Regelmäßig speichern: Obwohl automatisches Speichern vorhanden ist, können Sie jederzeit auf "Bearbeitung abschließen" klicken, um zu veröffentlichen.

3. Verlassenswarnung: Wenn Sie versuchen, die Seite mit nicht gespeicherten Änderungen zu verlassen, zeigt der Browser eine Warnung an.

4. Projektbilder: Bevorzugen Sie Bilder, die bereits in das Projekt hochgeladen wurden. Sie werden sicher gespeichert und können zusammen mit dem Dokument heruntergeladen werden.

5. Medienlinks: Für Videos und Audios fügen Sie zuerst den Link im Ordner hinzu über "Video-Link hinzufügen" oder "Audio-Link hinzufügen", dann fügen Sie ihn in das Dokument ein.

6. Vor dem Veröffentlichen lösen: Bevor Sie die Bearbeitung abschließen, überprüfen Sie im Kommentarmodus, ob es offene Diskussionen gibt, die gelöst oder beantwortet werden müssen.