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]
Mit Fußnote.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 { … }