Native Markdown workbench
ProMarkdown
Compose native Markdown reading and editing from a focused core and optional extensions.
Overview
Reusable Avalonia Markdown rendering and editing libraries with source-aware selection, hit testing, URI handling, and focused plugins for diagrams, math, syntax, and extended block formats.
ProMarkdown provides a native document surface rather than a WebView wrapper. The core owns source-aware layout, editing, selection, navigation, and themes; optional packages add richer Markdown dialects without forcing every application to ship the entire extension set.
Native Avalonia rendering and editing
Source-aware selection and hit testing
Mermaid, math, and syntax plugins
Alerts, containers, definitions, figures, and footers
Built for
Where it fits.
- Avalonia apps displaying rich Markdown documents
- Editor and agent-client authors needing native selection and navigation
- Products that want an extensible Markdown stack without a browser surface
Compatibility & status
10.0
Native controls
Rendering tests
Optional packages
In the work
Real output,
not a mockup.
Architecture
Clear layers.
Replaceable seams.
Parse
Markdig produces a source-aware document model for the core and registered extensions.
Layout
Native measurement and theme services resolve blocks, inlines, selection, and hit targets.
Edit
Source positions connect rendered content to caret, selection, and document updates.
Extend
Focused plugins add syntax, TextMate, Mermaid, math, alerts, containers, figures, and metadata blocks.
Quick start
From package
to first frame.
Choose the package workflow used by your repository, then start from the smallest working example. Replace VERSION with the current stable or prerelease version shown on NuGet.
dotnet add package ProMarkdowndotnet add package ProMarkdown.Plugin.Mermaid<PackageReference Include="ProMarkdown" Version="VERSION" /><PackageVersion Include="ProMarkdown" Version="VERSION" /><markdown:MarkdownView Markdown="{Binding Document}" EnableSelection="True" />Package surface
Start focused.
Compose as needed.
Core parsing, rendering, editing, layout, selection, and theme services.
↗02ProMarkdown.Plugin.MermaidMermaid diagram rendering.
↗03ProMarkdown.Plugin.MathInline and block math support.
↗04ProMarkdown.Plugin.TextMateTextMate-backed highlighting and editor integration.
↗05ProMarkdown.Plugin.SyntaxHighlightingBuilt-in code-block syntax highlighting.
↗Source, docs, samples, and releases
The repository is the source of truth.
Use the current documentation and samples, inspect changes, report issues, or support continued open-source maintenance.