SidebarLayout

MarkdownEditor

Formatieren wie im RichTextEditor – per Toolbar und mit sofort sichtbarem Ergebnis – gebunden und gespeichert wird aber Markdown. Die Toolbar bietet nur an, was es in Markdown gibt.

Bearbeiten und Markdown ansehen

Oben der Editor, darunter links das gebundene Markdown und rechts die Anzeige mit MarkdownView. Der Wert wird beim Verlassen des Editors übernommen.

Gebundenes Markdown (788 Zeichen)
# Projektnotiz

Ein Absatz mit **fett**, *kursiv*, ~~durchgestrichen~~ und `Code im Text`. Mehr dazu unter [Onesown](https://www.onesown.at).

## Zeichen und Platzhalter

Hallo {name}, dein Termin ist am {datum}.

Protokoll: <Thema>, 3 < 4 und Tom & Jerry, dazu ==markiert==.

Tool-Namen in Code wie `calculate_travel_expenses` oder im Text wie calculate\_travel\_expenses.

## Umbrüche

Erste Zeile, danach ein harter Umbruch (Umschalt+Enter)  
zweite Zeile im selben Absatz.

Ein neuer Absatz entsteht mit Enter.

## Aufgaben

- [x] Toolbar festlegen
- [ ] Demo prüfen

## Liste

1. Erster Punkt
2. Zweiter Punkt
   - Unterpunkt

> Ein Zitat.

```csharp
var markdown = OoMarkdown.FromHtml(html);
```

| Spalte A | Spalte B |
| --- | --- |
| 1 | 2 |
Anzeige mit MarkdownView

Projektnotiz

Ein Absatz mit fett, kursiv, durchgestrichen und Code im Text. Mehr dazu unter Onesown.

Zeichen und Platzhalter

Hallo {name}, dein Termin ist am {datum}.

Protokoll: <Thema>, 3 < 4 und Tom & Jerry, dazu markiert.

Tool-Namen in Code wie calculate_travel_expenses oder im Text wie calculate_travel_expenses.

Umbrüche

Erste Zeile, danach ein harter Umbruch (Umschalt+Enter)
zweite Zeile im selben Absatz.

Ein neuer Absatz entsteht mit Enter.

Aufgaben

  • Toolbar festlegen
  • Demo prüfen

Liste

  1. Erster Punkt
  2. Zweiter Punkt
    • Unterpunkt

Ein Zitat.

var markdown = OoMarkdown.FromHtml(html);
Spalte A Spalte B
1 2

Hin- und Rückumwandlung prüfen

Zeigt, was der Editor beim Speichern aus vorhandenem Markdown macht: links eigenes Markdown, rechts das Ergebnis von MarkdownEditor.MarkdownZuEditorHtml und danach OoMarkdown.FromHtml, wie im Editor. Geänderte Zeilen sind markiert: − vorher, + nachher. Vorbefüllt mit Fällen, die erhalten bleiben, und solchen, die sich ändern.

Geändert: 18 Zeilen
# Bleibt erhalten
Platzhalter wie {name} und {datum}.
Spitze Klammern: Protokoll <Thema>, 3 < 4 und Tom & Jerry.
Markiert: ==wichtig==, Code: `<div>` und `a && b`.
# Ändert sich
− Ein Satz pro Zeile.
− Ohne Leerzeile wird daraus ein Absatz.
+ Ein Satz pro Zeile. Ohne Leerzeile wird daraus ein Absatz.
− Harter Umbruch mit Backslash\
+ Harter Umbruch mit Backslash
wird zu zwei Leerzeichen am Zeilenende.
− Tool-Namen wie calculate_travel_expenses und 50 km * 0,42 €.
+ Tool-Namen wie calculate\_travel\_expenses und 50 km \* 0,42 €.
− * Liste mit Stern
− * wird zur Liste mit Bindestrich
+ - Liste mit Stern
+ - wird zur Liste mit Bindestrich
− Das ist _kursiv_ und __fett__.
+ Das ist *kursiv* und **fett**.
− :::hinweis
Container verlieren ihre Hülle.
− :::
Mehrere Leerzeilen
−
werden zu einer.
−
− ![Bild](https://www.onesown.at/bild.png)
<h1 id="bleibt-erhalten">Bleibt erhalten</h1>
<p>Platzhalter wie {name} und {datum}.</p>
<p>Spitze Klammern: Protokoll &lt;Thema&gt;, 3 &lt; 4 und Tom &amp; Jerry.</p>
<p>Markiert: <mark>wichtig</mark>, Code: <code>&lt;div&gt;</code> und <code>a &amp;&amp; b</code>.</p>
<h1 id="andert-sich">Ändert sich</h1>
<p>Ein Satz pro Zeile.
Ohne Leerzeile wird daraus ein Absatz.</p>
<p>Harter Umbruch mit Backslash<br />
wird zu zwei Leerzeichen am Zeilenende.</p>
<p>Tool-Namen wie calculate_travel_expenses und 50 km * 0,42 €.</p>
<ul>
<li>Liste mit Stern</li>
<li>wird zur Liste mit Bindestrich</li>
</ul>
<p>Das ist <em>kursiv</em> und <strong>fett</strong>.</p>
<div class="hinweis"><p>Container verlieren ihre Hülle.</p>
</div>
<p>Mehrere Leerzeilen</p>
<p>werden zu einer.</p>
<p><img src="https://www.onesown.at/bild.png" alt="Bild" /></p>

Steuern und Ereignisse

Placeholder im leeren Editor, MaxHeight mit scrollendem Inhalt, FokussierenAsync(), Wert von außen setzen oder leeren und Readonly umschalten. AfterValueChanged zählt die Änderungen, AutoSaveCallback meldet das Speichern.

Wert:

Änderungen: 0 · Zuletzt gespeichert: –

Toolbar beim Scrollen

Standardmäßig bleibt die Toolbar beim Scrollen oben stehen (ToolbarSticky). ToolbarStickySelector nimmt die Höhe eines fixen Headers als Abstand, ToolbarStickyOffset korrigiert in Pixeln. Rechts mit ToolbarSticky="false" und Size="OoSize.Sm".

Wert: 889 Zeichen

Nur lesen

Readonly="true" sperrt Eingabe und Toolbar.

Validierung

Pflichtfeld-Validierung mit ShowValidationTooltip.

Wert:

SKILL.md – Markdowneditor
---
name: MarkdownEditor
description: Onesown Blazor Komponente MarkdownEditor (Inputs). Verwende diesen Skill wenn du die MarkdownEditor-Komponente verwenden, konfigurieren oder debuggen moechtest.
---

# MarkdownEditor

**Namespace:** `Onesown.Blazor.Components`  
**Kategorie:** Inputs  
**Basisklasse:** `FormControlBase`  

Markdown-Editor mit gewohnter WYSIWYG-Bedienung: der User formatiert per Toolbar wie im RichTextEditor und sieht das Ergebnis sofort, gebunden und gespeichert wird aber Markdown. Basiert auf dem RichTextEditor (Jodit) mit einer Toolbar, die nur Markdown-Formatierungen anbietet.

**Live-Demo:** https://components.schini.com/demo/markdowneditor  

## Parameter

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Value`` | ``string`` |  | Aktuell gebundener Markdown-Text. |
| ``ValueChanged`` | ``EventCallback<string>`` |  | EventCallback für Two-Way-Binding mit @bind-Value. Liefert das Markdown nach jeder Änderung. |
| ``ValueExpression`` | ``Expression<Func<object>>`` |  | LINQ-Expression auf die gebundene Model-Property. Wird benötigt für DataAnnotations-Validierung und Label. |
| ``Readonly`` | ``bool`` |  | Setzt den Editor in den Nur-Lesen-Modus: keine Eingabe, Toolbar deaktiviert. Standard: false. |
| ``MaxHeight`` | ``int?`` |  | Maximale Höhe des Editors in Pixeln. Danach wird der Inhalt scrollbar. Ohne Angabe keine Begrenzung. |
| ``ToolbarSticky`` | ``bool`` | ``true`` | Hält die Toolbar beim Scrollen am oberen Rand fest. Standard: true. |
| ``ToolbarStickySelector`` | ``string`` |  | CSS-Selektor eines fixen Header-Elements (z. B. ".seiten-kopf"), dessen Höhe als Abstand für die festgehaltene Toolbar dient. Optional. |
| ``ToolbarStickyOffset`` | ``int`` | ``0`` | Pixel-Korrektur für den Abstand der festgehaltenen Toolbar (positiv oder negativ). Standard: 0. |

## Geerbte Parameter (FormControlBase)

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Size`` | ``string`` | ``OoSize.Md`` | Größe der Komponente. Mögliche Werte: OoSize.Xs, OoSize.Sm, OoSize.Md, OoSize.Lg, OoSize.Xl. Wird als CSS-Klasse am Root-Element gesetzt. |
| ``Id`` | ``string`` | ``Generator.GenerateRandomHtmlTagID()`` | Eindeutige HTML-ID des Input-Elements. Wird automatisch generiert und kann überschrieben werden (z. B. für Labels mit for-Attribut). |
| ``ShowLabel`` | ``bool`` | ``true`` | Blendet das Label über dem Eingabefeld ein oder aus. Standard: true. |
| ``IsFloatingLabel`` | ``bool`` | ``true`` | Aktiviert das schwebende Label (Floating Label), das beim Fokus oder bei Eingabe nach oben animiert. false = festes Label über dem Feld. Standard: true bzw. OoDefaults.Input.IsFloatingLabel. |
| ``Label`` | ``string`` |  | Beschriftung des Eingabefelds. Wird auch als Accessible-Name für Screenreader verwendet. |
| ``Placeholder`` | ``string`` | ``" "`` | Platzhaltertext im leeren Eingabefeld. Standard: Leerzeichen (verhindert Floating-Label-Sprung in Chrome). |
| ``AutoSaveCallback`` | ``EventCallback`` |  | Wird nach jeder Wertänderung ausgelöst und signalisiert der Seite, dass gespeichert werden soll. Kombinierbar mit TriggerAutoSaveCallbackOnlyIfValid. |
| ``TriggerAutoSaveCallbackOnlyIfValid`` | ``bool`` | ``true`` | Steuert ob AutoSaveCallback nur bei gültigem Wert ausgelöst wird. Standard: true. |
| ``AfterValueChanged`` | ``EventCallback`` |  | Wird nach jeder Wertänderung ausgelöst, unabhängig von der Gültigkeit des Werts. Geeignet für Live-Vorschau oder Seiteneffekte. |
| ``ShowValidationTooltip`` | ``bool`` | ``false`` | Zeigt Validierungsmeldungen als Tooltip neben dem Feld statt als Text darunter. Standard: false. |

## Hinweise

- Immer @bind-Value für Two-Way-Binding verwenden
- Für Formular-Validierung ValueExpression="() => _model.Property" setzen
- Komponente muss innerhalb eines &lt;Form&gt;- oder &lt;EditForm&gt;-Containers liegen, damit der EditContext greift
- AutoSaveCallback wird nach jeder gültigen Änderung ausgelöst, wenn TriggerAutoSaveCallbackOnlyIfValid=true (Standard)
- AfterValueChanged wird nach jeder Änderung ausgelöst, unabhängig von der Gültigkeit
- ShowValidationTooltip=true zeigt Validierungsmeldungen als Tooltip statt unter dem Feld
- Eingabefelder (nicht Button/ToggleButton): Defaults für IsFloatingLabel und Size über DefaultsBereich (Input, ersatzweise Size), appweit im Root-Layout; ein Parameter an der Instanz hat Vorrang
- Ändert sich nur ein Cascading-Wert, werden die direkten Parameter nicht erneut gesetzt: Ein Eingabefeld rendert beim Tippen nie den vorigen Wert; inhaltlich gleiche OoDefaults lösen kein Rendern aus
- Wert: @bind-Value liefert und erwartet Markdown; die Umwandlung übernehmen OoMarkdown.ToHtml (Laden) und OoMarkdown.FromHtml (Speichern)
- Toolbar: Überschriften 1–4, Zitat, Code-Block mit Sprache, Code im Text, fett, kursiv, durchgestrichen, Listen, Todo-Liste, Link, Tabelle, Trennlinie
- Nicht unterstützt: Bilder, Unterstreichen, Farben, Schriftarten, Ausrichtung – beim Einfügen werden solche Formatierungen entfernt, der Text bleibt
- Der Wert wird wie beim RichTextEditor beim Verlassen des Editors übernommen
- Validierung: in einem Form mit @bind-Value="_model.Text" greifen DataAnnotations (z. B. [Required], [MaxLength] auf das Markdown); @bind-Value setzt ValueExpression selbst, nicht zusätzlich angeben
- Anzeige des Ergebnisses: MarkdownView mit dem Parameter Markdown
- Vorhandenes Markdown wird beim Speichern vereinheitlicht, Bedeutung und Anzeige bleiben gleich: Listen mit "-", *kursiv*, **fett**
- Ein einfacher Zeilenumbruch in einem Absatz ist in Markdown kein Umbruch und wird zum Leerzeichen; erhalten bleibt ein harter Umbruch (zwei Leerzeichen am Zeilenende, im Editor Umschalt+Enter; ein Backslash am Zeilenende wird zu zwei Leerzeichen); mehrere Leerzeilen werden zu einer
- _ und * im Fließtext bekommen einen Backslash (calculate\_total), in `Code` nicht
- Container wie :::hinweis verlieren ihre Hülle, der Text bleibt; Bilder werden entfernt
- Unverändert bleiben {platzhalter}, &lt;, &gt;, &amp; und ==markiert==
- Was aus einem Text wird, zeigt die Demo im Abschnitt „Hin- und Rückumwandlung prüfen“
- IsFloatingLabel hat hier keine Wirkung, das Label steht immer fest über dem Editor; OoDefaults.Input.IsFloatingLabel wird nicht übernommen


Die Verbindung zum Server ist unterbrochen. Verbinde neu …

Neu verbinden hat nicht geklappt. Nächster Versuch in Sekunden.

Keine Verbindung zum Server. Bitte erneut versuchen oder die Seite neu laden.

Der Server hat die Sitzung angehalten.

Die Sitzung ließ sich nicht fortsetzen. Bitte erneut versuchen oder die Seite neu laden.