# Editor

> Block-Editor mit Slash-Menü, Markdown-Ansicht, Vorschau, Eigenschaften und automatischem Speichern.

Klickst du in der Seitenliste eines Bereichs auf eine Seite, öffnet sich der Editor. Oben stehen Titel und
Kurzbeschreibung der Seite, darunter der Inhalt.

## Zwei Ansichten: Bausteine und Markdown

Über dem Inhalt schaltest du zwischen **Bausteine** (visueller Editor) und **Markdown** (Quelltext) um. Beide
Ansichten bearbeiten denselben Inhalt – was du in der einen Ansicht änderst, steht exakt so in der anderen. Die
Markdown-Ansicht eignet sich für schnelle Änderungen an vielen Stellen oder zum Einfügen von Text aus anderen Quellen.

## Slash-Menü

Tippe im Bausteine-Modus `/` am Anfang einer Zeile. Es öffnet sich ein Menü mit allen Bausteinen, sortiert nach:

| Gruppe | Bausteine |
|---|---|
| **Text** | Text, Überschrift, Zwischenüberschrift, Aufzählung, Nummerierte Liste, Checkliste, Zitat, Codeblock, Trennlinie, Tabelle |
| **Bausteine** | Hinweis: Info, Hinweis: Tipp, Hinweis: Warnung, Hinweis: Gefahr, Tabs, Schritte, Karten, Aufklappbar, Spalten, Code-Gruppe |
| **Medien** | Bild, Screenshot, Einbettung (Video, Figma …), Datei |
| **Erweitert** | Diagramm (Mermaid), Formel, Button, Unterseiten-Liste, Badge, Tastenkürzel |

Tippe nach dem `/` weiter, um die Liste zu filtern (z. B. `/tab`). Was die Bausteine können, steht unter
[Bausteine](doc:bausteine).

## Text formatieren

Markierst du Text, erscheint eine kleine Werkzeugleiste: **Fett**, *Kursiv*, Durchgestrichen, Code, Link sowie
Überschrift und Zwischenüberschrift. Für Links auf andere Seiten gibst du `page:<seiten-kürzel>` statt einer URL ein
(siehe [Bausteine](doc:bausteine), Abschnitt „Links“). Absätze verschiebst du am Griff links neben dem Block.

## Speichern

Docsello speichert jede Änderung nach kurzer Pause automatisch als Entwurf (oder sofort mit `Strg+S` bzw. `Cmd+S`).
Der Status steht oben links: *Speichert …*, *Gespeichert* oder eine Fehlermeldung. Daneben zeigt ein Abzeichen den
Zustand der Seite:

| Abzeichen | Bedeutung |
|---|---|
| **Entwurf** | Die Seite wurde noch nie veröffentlicht |
| **Unveröffentlichte Änderungen** | Live ist eine ältere Fassung |
| **Live** | Entwurf und Live-Fassung sind gleich |

In der Seitenliste markiert ein Punkt Seiten mit unveröffentlichten Änderungen.

## Werkzeugleiste oben rechts

- **Live ansehen** – öffnet die veröffentlichte Seite.
- **Vorschau** – zeigt neben dem Editor, wie die Seite live aussieht, und listet defekte Links auf.
- **Verlauf** – alle veröffentlichten Fassungen, siehe [Papierkorb & Verlauf](doc:papierkorb-und-verlauf).
- **Eigenschaften** – siehe unten.
- **Veröffentlichen** – macht den Entwurf live. Im Feld *Was hat sich geändert? (optional)* kannst du eine Notiz
  für den Verlauf hinterlassen. In Bereichen mit Review-Pflicht steht hier **Zur Prüfung einreichen**.

## Eigenschaften einer Seite

| Einstellung | Bedeutung |
|---|---|
| **URL-Kürzel** | Letzter Teil der Adresse. Ändert die Adresse dieser Seite und aller Unterseiten |
| **Sichtbarkeit** | *Wie der Bereich (Standard)* oder strenger, siehe [Sichtbarkeit](doc:sichtbarkeit) |
| **Nur für bestimmte Personen/Gruppen freigeben …** | Seite auf einzelne Personen oder Gruppen beschränken |
| **In Navigation und Suche ausblenden** | Seite bleibt per Link erreichbar, taucht aber nicht in Navigation und Suche auf |
| **Übersetzungen** | Übersetzungen anlegen und öffnen, siehe [Versionen & Sprachen](doc:versionen-und-sprachen) |
| **Veröffentlichung zurückziehen** | Seite ist danach nicht mehr live, der Inhalt bleibt erhalten |
| **In den Papierkorb** | Seite samt Unterseiten löschen (wiederherstellbar) |

Das Symbol einer Seite wählst du links neben dem Titel.

## Frontmatter beim Hochladen

Lädst du Markdown-Dateien hoch (per [CLI](doc:cli) oder [REST-API](doc:rest-api)), liest Docsello am Anfang jeder
Datei einen Frontmatter-Block:

```yaml
---
title: Zahlungen
description: Erscheint in der Suche und in Link-Vorschauen
icon: credit-card
---
```

Außerdem versteht der Import `order` (Reihenfolge), `visibility`, `date` (für Changelog-Einträge), `slug`,
`hidden: true` (in Navigation und Suche ausblenden) und `toc: false` (kein Inhaltsverzeichnis auf dieser Seite).
Fehlen `hidden` oder `toc`, bleibt die Einstellung der Seite, wie sie ist; `hidden: false` bzw. `toc: true` heben
sie wieder auf. Fehlt `title`, wird die erste `# Überschrift` zum Titel und nicht doppelt angezeigt. Details:
[CLI](doc:cli), Abschnitt „Ordner-Aufbau“.