syncfusion/wpf-ui-components-skills / skills/syncfusion-wpf-markdown-viewer
syncfusion-wpf-markdown-viewer
VerifiedImplement Syncfusion WPF SfMarkdownViewer for rendering and displaying Markdown content in WPF applications. Use this when rendering Markdown text, loading Markdown from strings or application-controlled local files, handling hyperlink clicks with URL validation, or displaying Mermaid diagrams with input sanitization. Covers the Source property, HyperlinkClicked events with allowlist-based navigation, and MermaidBlockTemplate customization with input validation. Always validate and sanitize Markdown content before assigning to Source, especially when the content originates from remote or user-supplied sources.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.1 KB |
| references/events.md | markdown | 4.7 KB |
| references/getting-started.md | markdown | 3.2 KB |
| references/loading-content.md | markdown | 6.5 KB |
| references/mermaid-diagrams.md | markdown | 6.7 KB |
references/mermaid-diagrams.md
View on GitHub# Mermaid Diagrams
`SfMarkdownViewer` supports rendering Mermaid diagrams embedded in Markdown via the `MermaidBlockTemplate` property. When a fenced code block with ` ```mermaid ` is encountered, the control uses this template instead of the default code block display.
## Required Dependencies
Mermaid rendering requires `SfDiagram`. Add the assembly reference:
- `Syncfusion.SfDiagram.WPF`
And import the namespace in XAML:
```xaml
xmlns:diagram="clr-namespace:Syncfusion.UI.Xaml.Diagram;assembly=Syncfusion.SfDiagram.WPF"
```
---
## MermaidBlockTemplate Property
`MermaidBlockTemplate` accepts a `DataTemplate`. When a `mermaid` code block is found in the Markdown, the control instantiates this template and passes the raw Mermaid text as `DataContext`.
> ⚠️ **Security note:** The `DataContext` string comes directly from the Markdown source. If that Markdown was loaded from a remote or user-supplied source, treat this string as untrusted. Validate it before passing to `LoadDiagramFromMermaid()` — at minimum check that it is non-null, within a reasonable length limit, and matches expected Mermaid syntax patterns.
---
## Full Example — Flowchart in Markdown
**XAML:**
```xaml
<Window
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:syncfusion="clr-namespace:Syncfusion.UI.Xaml.Markdown;assembly=Syncfusion.SfMarkdownViewer.WPF"
xmlns:diagram="clr-namespace:Syncfusion.UI.Xaml.Diagram;assembly=Syncfusion.SfDiagram.WPF"
xmlns:system="clr-namespace:System;assembly=mscorlib">
<Grid>
<syncfusion:SfMarkdownViewer>
<syncfusion:SfMarkdownViewer.MermaidBlockTemplate>
<DataTemplate>
<diagram:SfDiagram
x:Name="mermaidDiagram"
Height="600" Width="1000"
Focusable="False"
Foreground="Black"
HorizontalAlignment="Left"
HorizontalContentAlignment="Left"
Loaded="mermaidDiagram_Loaded" />
</DataTemplate>
</syncfusion:SfMarkdownViewer.MermaidBlockTemplate>
<syncfusion:SfMarkdownViewer.Source>
<system:String xml:space="preserve">
<![CDATA[
# Mermaid Flowchart
```mermaid
flowchart TD
A[User Opens App] --> B[MarkdownViewer Loads]
B --> C{Contains Mermaid?}
C -->|Yes| D[Render Diagram]
C -->|No| E[Render Plain Markdown]
D --> F[Display Enhanced Output]
E --> F
```
]]>
</system:String>
</syncfusion:SfMarkdownViewer.Source>
</syncfusion:SfMarkdownViewer>
</Grid>
</Window>
```
**C# — Loaded event handler:**
```csharp
using Syncfusion.UI.Xaml.Diagram;
using Syncfusion.UI.Xaml.Diagram.Layout;
// Maximum length allowed for a Mermaid block — adjust to your app's requirements
private const int MaxMermaidLength = 10_000;
private void mermaidDiagram_Loaded(object sender, RoutedEventArgs e)
{
if (sender is SfDiagram diagram)
{
// Disable default page settings for clean rendering
diagram.PageSettings = null;
diagram.ScrollSettings.ScrollLimit = ScrollLimit.Limited;
// Get the Mermaid text from DataContext (set by the viewer)
var mermaidText = diagram.DataContext as string;
// Validate the Mermaid source before rendering
// DataContext originates from Markdown content which may be untrusted
if (string.IsNullOrWhiteSpace(mermaidText))
return;
if (mermaidText.Length > MaxMermaidLength)
{
// Reject oversized payloads — could be a DoS or injection attempt
return;
}
// Only render known supported diagram types
var trimmed = mermaidText.TrimStart();
var supportedPrefixes = new[] { "flowchart ", "flowchart\n", "graph " };
bool isSupportedType = Array.Exists(supportedPrefixes,
p => trimmed.StartsWith(p, StringComparison.OrdinalIgnoreCase));
if (!isSupportedType)
{
// Unsupported or unexpected diagram type — skip rendering
return;
}
// Configure flowchart layout
diagram.LayoutManager = new LayoutManager
{
Layout = new FlowchartLayout
{
Orientation = FlowchartOrientation.TopToBottom,
HorizontalSpacing = 80,
VerticalSpacing = 60,
Margin = new Thickness(0, 50, 0, 0),
}
};
// Parse and render the validated Mermaid diagram
diagram.LoadDiagramFromMermaid(mermaidText);
}
}
```
---
## FlowchartLayout Options
| Property | Type | Default | Description |
|---|---|---|---|
| `Orientation` | `FlowchartOrientation` | `TopToBottom` | Flow direction: `TopToBottom` or `LeftToRight` |
| `HorizontalSpacing` | `double` | — | Horizontal gap between nodes |
| `VerticalSpacing` | `double` | — | Vertical gap between nodes |
| `Margin` | `Thickness` | — | Margin around the entire diagram |
---
## How It Works
1. `SfMarkdownViewer` parses the Markdown and detects ` ```mermaid ` fenced blocks
2. For each such block, it instantiates the `MermaidBlockTemplate` DataTemplate
3. The raw Mermaid text is passed as `DataContext` to the templated element
4. In the `Loaded` handler, `diagram.DataContext as string` retrieves the Mermaid definition
5. `diagram.LoadDiagramFromMermaid(mermaidText)` renders the diagram
---
## Gotchas
- **`SfDiagram` assembly is required** — without `Syncfusion.SfDiagram.WPF`, the template cannot be created; install the NuGet package `Syncfusion.SfDiagram.WPF`
- **`DataContext` is untrusted input** — the raw Mermaid string comes from Markdown content which may originate from remote or user-supplied sources; always validate length, content type, and diagram type prefix before calling `LoadDiagramFromMermaid()`
- **Allowlist diagram types** — check that the Mermaid block starts with a known supported keyword (e.g., `flowchart`, `graph`) before rendering; reject unrecognized types
- **Enforce a length limit** — large Mermaid payloads can cause DoS; reject strings above a reasonable maximum (e.g., 10 000 characters)
- **`PageSettings = null` is recommended** — setting it prevents the default page border from interfering with diagram sizing
- **Fixed Width/Height** — set explicit `Width` and `Height` on the `SfDiagram` in the template; auto-sizing may not work correctly for all diagram sizes
- **Only `flowchart` type is shown in docs** — other Mermaid diagram types (sequence, gantt, etc.) may or may not be supported; verify with your Syncfusion version
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |