SidebarLayout

MarkdownView

Zeigt Markdown als formatierten Text: Markdig auf dem Server, danach im Browser Syntaxfarben, Formeln, Kopierknöpfe, Mermaid-Diagramme und eine Lightbox für Bilder. Die Anwendung braucht dafür weder Markdig noch eigenes CSS oder JavaScript.

Fertiger Text

Überschriften, Listen, Aufgaben, Tabelle, Zitat, Code, Formel, Diagramm, Fußnote und ein Bild (Klick öffnet die Lightbox).

Überschrift

Text mit fett, kursiv, markiert, Code und einem Link (öffnet im neuen Tab).

  • Punkt eins

  • Punkt zwei

    • eingerückt
  • erledigt

  • offen

Sprache Typisierung Laufzeit
C# statisch .NET
JavaScript dynamisch Browser

Ein Zitat, abgesetzt und gedämpft.

var antwort = await agent.RunAsync("Hallo");
Console.WriteLine(antwort.Text);

Formel im Text \(E = mc^2\) und abgesetzt:

\(\sum_{i=1}^{n} i = \frac{n(n+1)}{2}\)

graph LR
    A[Markdown] --> B[Markdig] --> C[MarkdownView]

Beispielbild

Mit Fußnote.1


  1. Die Fußnote steht am Ende.↩

Text, der noch wächst (Streaming)

Complete="false", solange Text nachkommt: Syntaxfarben und Formeln sofort, Kopierknöpfe und Diagramme erst am Ende.

Complete: True


Eingabe

Eigenen Markdown-Text eingeben; die Ansicht folgt beim Verlassen des Felds.


Hallo

Das ist Markdown.

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

# MarkdownView

**Namespace:** `Onesown.Blazor.Components`  
**Kategorie:** Viewer  
**Basisklasse:** `OoComponentBase`  

Zeigt Markdown als formatierten Text: Umwandlung mit Markdig auf dem Server, danach im Browser Syntaxfarben, Formeln (KaTeX), Kopierknöpfe an Codeblöcken, Mermaid-Diagramme und eine Lightbox für Bilder. Geeignet für fertige Texte und für Text, der noch wächst, etwa die gestreamte Antwort eines Sprachmodells.

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

## Parameter

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Markdown`` | ``string`` |  | Der anzuzeigende Markdown-Text. Bei jeder Änderung wird neu umgewandelt; null oder leer zeigt nichts an. |
| ``Complete`` | ``bool`` | ``true`` | false, solange der Text noch wächst (Streaming). Dann gibt es schon Syntaxfarben und Formeln, aber noch keine Kopierknöpfe und Diagramme, die ein unvollständiger Text nicht verträgt. Standard: true. |
| ``Pipeline`` | ``MarkdownPipeline`` |  | Eigene Markdig-Pipeline. Standard: OoMarkdown.DefaultPipeline (UseAdvancedExtensions, HTML im Text abgeschaltet). |
| ``OpenLinksInNewTab`` | ``bool`` | ``true`` | Links (nicht Bilder) öffnen in einem neuen Tab, damit die Seite erhalten bleibt. Standard: true. |
| ``EnableImageLightbox`` | ``bool`` | ``true`` | Ein Klick auf ein Bild öffnet es groß; mit den Pfeilen geht es zu den übrigen Bildern des Texts. Bilder in Links bleiben Links. Standard: true. |

## Geerbte Parameter (OoComponentBase)

Alle nicht deklarierten HTML-Attribute (``class``, ``style``, ``data-*``, ``aria-*``, ...) werden an das Root-Element weitergereicht.

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Size`` | ``string`` |  | 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. |

## Hinweise

- Natives HTML-Attribut class wird automatisch an das Root-Element weitergegeben
- Natives HTML-Attribut style wird automatisch an das Root-Element weitergegeben
- Alle weiteren nicht deklarierten Attribute (data-*, aria-*, id, tabindex, …) werden ebenfalls weitergereicht
- Größe der Komponente via Size mit OoSize-Konstanten steuern (OoSize.Xs bis OoSize.Xl)
- Einfachster Fall: <MarkdownView Markdown="@_text" /> – die Anwendung braucht weder Markdig noch eigenes CSS oder JavaScript
- Wächst der Text noch (Streaming), Complete="false" setzen und am Ende auf true: Syntaxfarben und Formeln erscheinen sofort, Kopierknöpfe und Diagramme erst, wenn der Text fertig ist
- Schriftgröße über Size, etwa Size="@OoSize.Lg"; ohne Size erbt der Text die Schriftgröße der Umgebung
- HTML im Text wird als Text gezeigt, nicht ausgeführt; wer HTML erlauben will, übergibt eine eigene Pipeline
- Links öffnen standardmäßig in einem neuen Tab (OpenLinksInNewTab), Bilder per Klick in einer Lightbox (EnableImageLightbox)
- Abstände zwischen Blöcken, Überschriften, Listen, Tabellen (seitlich scrollbar), Zitate und Fußnoten gestaltet die Komponente selbst (CSS-Klasse oo-markdown)
- Eigene Container wie :::hinweis erscheinen als <div class="hinweis">; ihr Aussehen legt die Anwendung fest, etwa .oo-markdown .hinweis { … }


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.