Markdown und Mermaid-Diagramme in Power BI — ein praktischer Leitfaden
Ein Überblick über Funktionen, Einrichtung und Einsatzmöglichkeiten des kostenlosen Markdown / Mermaid Renderer Visuals für Power BI.
published on 2026-03-31
Power BI ist ein hervorragendes Werkzeug für Datenvisualisierung. Was oft fehlt, ist eine einfache Möglichkeit, formatierten Text, Erklärungen oder Prozessdiagramme direkt im Bericht darzustellen. Genau dafür gibt es den Markdown / Mermaid Renderer — ein kostenloses, quelloffenes Custom Visual, das Markdown-Inhalte einschließlich Mermaid-Diagramme direkt in Power BI rendert.
In diesem Artikel zeige ich, wie das Visual eingerichtet wird, welche Funktionen es bietet und für welche Anwendungsfälle es sich besonders gut eignet.
Was ist der Markdown / Mermaid Renderer?
Das Visual nimmt Markdown-Text aus einer Spalte oder einem Measure entgegen und rendert daraus formatierten Inhalt — Überschriften, Listen, Tabellen, Code-Blöcke und eben auch Mermaid-Diagramme. Alles passiert lokal im Browser, ohne externe Netzwerkaufrufe.
flowchart LR
A["Spalte oder Measure (Markdown-Text)"] --> B["Markdown / Mermaid Renderer Visual"]
B --> C["Formatierter Inhalt + Diagramme"]Das Visual ist unter der MIT-Lizenz verfügbar und kann frei für kommerzielle und persönliche Zwecke verwendet werden.
Einrichtung
Installation
Es gibt zwei Wege, das Visual zu installieren:
- AppSource: In Power BI Desktop unter Weitere Visuals abrufen nach "Markdown Mermaid Renderer" suchen und hinzufügen.
- Manuell: Die
.pbiviz-Datei von GitHub herunterladen und über Visual aus Datei importieren einbinden.
Erste Schritte
- Das Visual auf der Berichtsseite platzieren
- Eine Spalte oder ein Measure mit Markdown-Text in das Feld "Markdown Content" ziehen
- Der Inhalt wird sofort gerendert
Ein einfaches Beispiel-Measure zum Ausprobieren:
Projektübersicht =
"# Projekt Alpha
**Status:** Auf Kurs
**Verantwortlich:** Sarah M.
## Aktueller Sprint
- Datenmodell finalisieren
- KPI-Definitionen prüfen
- Deployment vorbereiten"Dies wird dann wie folgt gerendert:
Projekt Alpha
Status: Auf Kurs
Verantwortlich: Sarah M.Aktueller Sprint
- Datenmodell finalisieren
- KPI-Definitionen prüfen
- Deployment vorbereiten
Das Measure wird als formatiertes Dokument dargestellt — mit Überschriften, Fettdruck und Aufzählung.
Mermaid-Diagramme: Diagramme aus Text erzeugen
Was das Visual besonders nützlich macht, ist die Unterstützung von Mermaid. Mermaid ist eine textbasierte Diagrammsprache: Man beschreibt ein Diagramm als Code, und es wird als SVG gerendert. Kein Zeichentool, kein statischer Screenshot, der veraltet.
Ein Beispiel — ein einfaches Flussdiagramm:
```mermaid
flowchart LR
Quellen["Datenquellen"] --> ETL["ETL / Dataflows"]
ETL --> Modell["Semantisches Modell"]
Modell --> Berichte["Berichte & Dashboards"]
```Das wird direkt im Power BI-Bericht als interaktives SVG-Diagramm wie folgt gerendert:
flowchart LR
Quellen["Datenquellen"] --> ETL["ETL / Dataflows"]
ETL --> Modell["Semantisches Modell"]
Modell --> Berichte["Berichte & Dashboards"]Unterstützte Diagrammtypen
Mermaid unterstützt eine Vielzahl von Diagrammtypen, die alle im Visual funktionieren:
mindmap
root((Mermaid-Diagramme))
Prozesse
Flowcharts
Sequenzdiagramme
Datenarchitektur
ER-Diagramme
Klassendiagramme
Planung
Gantt-Charts
Quadrantendiagramme
Kommunikation
Kreisdiagramme
TimelinesMehrere Measures in einem Visual
Statt eines einzigen Measures können bis zu 10 Measures gleichzeitig ins Visual gezogen werden. Jedes Measure wird als eigener Abschnitt dargestellt. So können viele Elemente gemeinsam strukturiert dargestellt werden, anstatt viele einzelne Elemente jeweils in eigene Visuals unterzubringen (was oft kein schönes Design zur Folge hat)
flowchart LR
M1["Umsatz"] --> V["Markdown Visual"]
M2["Wachstumsrate"] --> V
M3["Top-Produkte"] --> V
V --> R["Strukturierter Berichtsabschnitt"]Formatierung pro Measure
Sobald zwei oder mehr Measures vorhanden sind, erscheint im Eigenschaftenbereich die Rubrik "Measure formatting". Dort lässt sich für jedes Measure eine Formatierungsfunktion wählen:
| Format | Effekt | Beispiel |
|---|---|---|
| None | Keine Formatierung (Standard) | Wert wird direkt gerendert |
| Heading (H1–H3) | Umschließt den Wert als Überschrift | ## Wert |
| Code Block | Darstellung als Code-Block | ```dax ... ``` |
| Definition List | Measure-Name als Label, Wert als Definition | Umsatz / : €1.234.567 |
| Blockquote | Darstellung als Zitatblock | > Wert |
| Unordered / Ordered List | Wert wird am Trennzeichen aufgeteilt | - Element 1 / - Element 2 |
Definition Lists für KPIs
Das Format Definition List eignet sich besonders gut für KPI-Darstellungen. Der Anzeigename des Measures wird automatisch als Label verwendet, der Wert als Definition:
Monatlich aktive Nutzer
: 14.832
Umsatz Q1
: €1.234.567Es ist keine String-Verkettung im DAX nötig — das Visual übernimmt die Formatierung. Der Anzeigename des Measures im Datenmodell steuert das Label.
Listen aus CONCATENATEX
Die Listenformate sind besonders nützlich in Kombination mit CONCATENATEX():
Top Produkte =
CONCATENATEX(
TOPN(3, Produkte, Produkte[Umsatz], DESC),
Produkte[Produktname],
", "
)Mit dem Format Ordered List und dem Trennzeichen , wird daraus:
Top Produkte
- Widget A
- Gadget B
- Modul C
Das Trennzeichen und die Überschriftenebene sind im Eigenschaftenbereich konfigurierbar.
DAX- und Power Query-Syntaxhervorhebung
Code-Blöcke mit den Sprachkennungen dax, powerquery, pq oder mscript werden mit Syntaxhervorhebung dargestellt:
```dax
Total Sales =
VAR _sales = SUMX(Sales, Sales[Quantity] * Sales[UnitPrice])
RETURN
IF(_sales > 0, _sales, BLANK())
``````powerquery
let
Source = Sql.Database("server", "db"),
Filtered = Table.SelectRows(Source, each [Status] = "Active")
in
Filtered
```Das ist besonders hilfreich, wenn DAX-Ausdrücke oder M-Skripte als Teil der Dokumentation im Bericht dargestellt werden sollen.
Darstellungsoptionen
Dark / Light Mode
Der Farbmodus lässt sich im Eigenschaftenbereich umschalten. Markdown-Inhalte, Mermaid-Diagramme und alle UI-Elemente passen sich automatisch an.
Schriftarten
Schriftart, Überschriftengröße, Textgröße und Mermaid-Schriftgröße sind unabhängig voneinander konfigurierbar.
Suche
Über die Einstellung "Use search bar" in den View Settings wird eine Suchleiste eingeblendet. Mit Ctrl+F lässt sich im gesamten gerenderten Inhalt suchen — hilfreich bei längeren Dokumentationen.
Vollbildmodus für Diagramme
Jedes Mermaid-Diagramm hat einen Vollbild-Button (⛶). Das ist nützlich für komplexe Diagramme, die im Detail betrachtet werden sollen. Zoom und Pan sind im Vollbildmodus verfügbar.
Copy-Markdown-Menü
Wenn "Copy markdown menu" aktiviert ist, bietet das Rechtsklick-Menü die Optionen Copy section markdown und Copy all markdown, um den Rohtext in die Zwischenablage zu kopieren.
Cross-Filtering: Dokumentation trifft Interaktivität
Wenn eine Spalte (nicht ein einzelnes Measure) als Datenquelle verwendet wird, wird jede Zeile als eigener Abschnitt gerendert. Mit aktiviertem Cross-Filter:
- Ein Klick auf einen Abschnitt filtert andere Visuals anhand der entsprechenden Datenzeile
Ctrl+Klickfür Mehrfachauswahl- Nicht ausgewählte Abschnitte werden abgedimmt
Das ermöglicht ein Muster, bei dem z.B. Prozessbeschreibungen oder Produktdokumentationen als klickbare Abschnitte fungieren und gleichzeitig die restlichen Berichtsvisuals filtern.
Praxisbeispiel: Automatische Measure-Dokumentation
Ein konkreter Anwendungsfall, der sich in wenigen Minuten einrichten lässt: die automatische Dokumentation aller Measures im Datenmodell.
Power BI Desktop (ab April 2024) stellt die Funktion INFO.VIEW.MEASURES() bereit, die Metadaten aller Measures zurückgibt. In Kombination mit CONCATENATEX() und etwas Markdown-Formatierung entsteht ein Measure, das eine vollständige, durchsuchbare Dokumentation aller Measures erzeugt.
flowchart LR
A["INFO.VIEW.MEASURES()"] -->|Measure-Metadaten| B["CONCATENATEX + Markdown"]
B --> C["Einzelnes DAX-Measure"]
C --> D["Markdown Visual"]
D --> E["Durchsuchbare Measure-Dokumentation"]Das DAX-Query
Im DAX Query View einfügen und ausführen. 'Measure' durch einen vorhandenen Tabellennamen im Modell ersetzen:
DEFINE
FUNCTION CodeFence =
( CodeContent : STRING VAL, CodeLanguage : STRING VAL) =>
VAR _fence = "` ` `"
VAR _nl = UNICHAR ( 10 )
RETURN
IF (
ISBLANK ( CodeContent ),
"",
_fence & CodeLanguage & _nl
& CodeContent & _nl & _fence
)
MEASURE 'Measure'[Measure Documentation] =
VAR _nl = UNICHAR ( 10 )
VAR _nl2 = _nl & _nl
VAR _measures = INFO.VIEW.MEASURES ()
VAR _result =
CONCATENATEX (
_measures,
VAR _header = "## " & [Name]
VAR _blockquote =
"> "
& IF (
ISBLANK ( [Description] ),
"_keine Beschreibung vorhanden_",
[Description]
)
VAR _list =
"- Tabelle : " & [Table] & _nl
& "- Anzeigeordner : "
& IF (
ISBLANK ( [DisplayFolder] ),
"–", [DisplayFolder]
) & _nl
& "- Datentyp : " & [DataType] & _nl
& "- Ausgeblendet : "
& IF ( [IsHidden], "Ja", "Nein" )
VAR _exprHeading = "### Ausdruck"
VAR _exprBlock =
CodeFence ( [Expression], "dax" )
VAR _formatHeading = "### Formatzeichenfolge"
VAR _formatBlock =
CodeFence (
[FormatStringDefinition], "dax"
)
RETURN
_header & _nl2
& _blockquote & _nl2
& _list & _nl2
& _exprHeading & _nl2
& _exprBlock
& IF (
NOT ISBLANK (
[FormatStringDefinition]
),
_nl2 & _formatHeading & _nl2
& _formatBlock,
""
),
_nl2 & "---" & _nl2,
[Name], ASC
)
RETURN
_result
EVALUATE
{ [Measure Documentation] }Nach der Ausführung das Measure per Rechtsklick über "Add to model" zum Datenmodell hinzufügen. Dann das Markdown Visual auf eine Berichtsseite setzen, das Measure in das Feld Markdown Content ziehen und die Suchleiste aktivieren.
Das Ergebnis: eine stets aktuelle, durchsuchbare Dokumentation aller Measures — direkt im Power BI-Bericht.
Tipps für den Einstieg
- Eigenen Beispielbericht laden: Im GitHub-Repository liegt im Ordner
pbi_example/ein fertiger.pbix-Bericht mit verschiedenen Diagrammtypen und Formatierungsoptionen. - Mermaid Live Editor nutzen: Unter mermaid.live können Diagramme vor dem Einfügen in Power BI ausprobiert werden.
- Suchleiste aktivieren: Gerade bei längeren Dokumentationen spart die eingebaute
Ctrl+F-Suche viel Zeit.
Verbindung zu fennibi.com
Das Markdown / Mermaid Renderer Visual entstand als Teil von fennibi.com — einer automatisierten Dokumentationslösung für Power BI Semantic Models. Fennibi generiert strukturierte Markdown-Dokumentation mit Mermaid-Diagrammen für Beziehungen, Lineage und Architektur, die dann über dieses Visual direkt im Power BI-Bericht dargestellt wird.
Das Visual funktioniert aber unabhängig von Fennibi mit jeder Markdown-Textquelle — ob aus einem DAX-Measure, einer SharePoint-Liste oder einer manuell gepflegten Dokumentationstabelle.
Zusammenfassung
| Eigenschaft | Details |
|---|---|
| Lizenz | MIT — kostenlos für jeden Einsatz |
| Installation | AppSource oder manuelle .pbiviz-Datei |
| Markdown-Rendering | Überschriften, Listen, Tabellen, Code-Blöcke, Fettdruck, Kursiv |
| Mermaid-Diagramme | Flowcharts, Sequenz-, ER-, Klassen-, Gantt-Diagramme und mehr |
| Syntaxhervorhebung | DAX, Power Query (M), und andere Sprachen |
| Formatierungsoptionen | Definition Lists, Listen, Code-Blöcke, Überschriften pro Measure |
| Interaktivität | Cross-Filtering, Zoom/Pan, Vollbild, Suche |
| Theming | Dark/Light Mode, konfigurierbare Schriftarten, Theme-Datei-Unterstützung |
| Sicherheit | Keine externen Netzwerkaufrufe, DOM-Sanitisierung |
| Quellcode | github.com/pmoldmann/mermaid-powerbi |
💬 Diskussion & Feedback
Fragen, Ideen oder Anmerkungen zum Mermaid Power BI Visual? Ich freue mich über jeden Kommentar — hinterlasse gerne eine Nachricht direkt unter dem LinkedIn-Beitrag zu diesem Artikel.
Tags: Power BI, Custom Visual, Markdown, Mermaid, Dokumentation, Power BI Development, Business Intelligence