DW-Editor: Formatierung

1. Übersicht und Zweck

Status: [Live] — dokumentiert die Syntax-Token-Zuordnung der vorhandenen Editor-Toolbars (EasyMDE für Markdown-Seiten, Core-Toolbar für DokuWiki-Syntax-Seiten; Umschaltung s. editors → Umschaltung). Referenz für die Kategorien-Auswahl (nicht für das Zielformat!): DevExpress ASPxHtmlEditor (https://demos.devexpress.com/ASPxHTMLEditorDemos/Default.aspx) — die dort gezeigten HTML-Tags gelten nicht für diese Bibliothek.

2. Voraussetzungen

Editor ↔ Markup- Umschaltung bereits verstanden.

3. Konzepte

Warum kein HTML: der Editor bearbeitet Wiki-Quelltext, kein HTML — dieselbe Leitplanke wie in den Grundlagen: Markup bleibt Speicherformat, WYSIWYG ist nur eine Ansicht darauf. Ein Formatierungsbefehl fügt deshalb nie <b>/<i>-Tags ein, sondern den passenden Syntax-Token — DokuWikis eigener Renderer (bzw. wvdsdwmds ParsedownRenderer bei Markdown-Seiten) übernimmt danach die HTML-Erzeugung.

4. Erste Schritte

Jeder Befehl schreibt DokuWiki-Syntax oder Markdown, je nach Speicherformat der bearbeiteten Seite (Marker-Autodetect entscheidet, welches Format eine Seite hat) — kein manueller Formatwahl-Schritt nötig.

5. Verwendung

Für Zeichenformate (Fett/Kursiv/…) Abschnitt 6, für Absatzformate (Überschriften/Listen/…) Abschnitt 7.

6. API-Referenz: Zeichenformate

Toolbar-Befehl	DokuWiki-Syntax	Markdown
Fett	`Text`	`Text`
Kursiv	`//Text//`	`_Text_`
Unterstrichen	`__Text__`	kein natives Markdown-Äquivalent — Befehl bleibt deaktiviert auf Markdown-Seiten (kein HTML-Ausweich, s. Abschnitt 3)
Durchgestrichen	`<del>Text</del>`	`~~Text~~`
Monospace (inline)	`''Text''`	`Text`
Hochgestellt/Tiefgestellt	`<sup>Text</sup>`/`<sub>Text</sub>`	kein natives Äquivalent — deaktiviert

7. Parameter, Optionen und Zustände: Absatzformate

Toolbar-Befehl	DokuWiki-Syntax	Markdown
Überschrift 1–5	`====== … ======` … `== … ==` (Ebene = Anzahl `=`)	`# …` … `##### …`
Ungeordnete Liste	`* Eintrag` (zwei Leerzeichen + Stern, eine physische Zeile je Eintrag — s. Abschnitt 9)	`- Eintrag`
Geordnete Liste	`- Eintrag`	`1. Eintrag`
Zitat/Blockquote	`> Text`	`> Text`
Codeblock	`<code lang>…</code>`	```lang … ``` (Fenced Code Block)

8. Vollständige Beispiele

Entfällt — reine Token-Referenztabelle, kein ausführbares Beispiel.

9. Einschränkungen und Randfälle

Falle: Listen-Zeilenumbruch. Ein WYSIWYG-Editor, der einen langen Listeneintrag automatisch visuell umbricht, darf beim Zurückserialisieren keinen echten Zeilenumbruch in den DokuWiki-Quelltext schreiben — ein Listeneintrag muss eine einzige physische Quelltextzeile bleiben, sonst fällt er beim nächsten Rendern aus der Liste und erscheint als rohes <pre> (dieselbe Falle, die bei mehreren Unterseiten dieser Doku-Runde von Hand korrigiert wurde — hier als Spezifikationsanforderung an einen künftigen Editor festgehalten, nicht nur als Autoren-Fehler).

10. Accessibility und Kompatibilität

Vollständiger Überblick: Accessibility.

11. Troubleshooting

Entfällt.

12. Verwandte Themen

Editoren und Code-Darstellung — Grundlagen und WYSIWYG-Vertrag
DW-Editor: Tabellen und Medien — Tabellen-/Medien-/Link-Syntax
Markdown (wvdsmd) — Markdown-Fluss, Marker-Autodetect