Zum Inhalt
← Zurück zum Blog

2026-03-31 8 Min. Lesezeit

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:

  1. AppSource: In Power BI Desktop unter Weitere Visuals abrufen nach "Markdown Mermaid Renderer" suchen und hinzufügen.
  2. Manuell: Die .pbiviz-Datei von GitHub herunterladen und über Visual aus Datei importieren einbinden.

Erste Schritte

  1. Das Visual auf der Berichtsseite platzieren
  2. Eine Spalte oder ein Measure mit Markdown-Text in das Feld "Markdown Content" ziehen
  3. 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
      Timelines

Mehrere 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.567

Es 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

  1. Widget A
  2. Gadget B
  3. 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+Klick fü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