Avalonia.Controls.Markdown
12.2.0
Prefix Reserved
dotnet add package Avalonia.Controls.Markdown --version 12.2.0
NuGet\Install-Package Avalonia.Controls.Markdown -Version 12.2.0
<PackageReference Include="Avalonia.Controls.Markdown" Version="12.2.0" />
<PackageVersion Include="Avalonia.Controls.Markdown" Version="12.2.0" />
<PackageReference Include="Avalonia.Controls.Markdown" />
paket add Avalonia.Controls.Markdown --version 12.2.0
#r "nuget: Avalonia.Controls.Markdown, 12.2.0"
#:package Avalonia.Controls.Markdown@12.2.0
#addin nuget:?package=Avalonia.Controls.Markdown&version=12.2.0
#tool nuget:?package=Avalonia.Controls.Markdown&version=12.2.0
Avalonia.Controls.Markdown
The Avalonia.Controls.Markdown package provides a Markdown rendering control for Avalonia applications. It enables you to display Markdown-formatted text with support for common Markdown features and styling.
Features
- Render Markdown content
- Styling support with named resources
Quick Start
Add the Avalonia.Controls.Markdown package to your Avalonia project.
XAML Usage
<Markdown xml:space="preserve">
# Markdown
## Headings
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6
**Bold Text**
*Italic Text*
~~Strikethrough~~
__Bold__ and _Italic_
[Link to Avalonia](https://avaloniaui.net)
`Inline code`
- Unordered list item 1
- Unordered list item 2
- Nested item 2a
- Nested item 2b
---
1. Ordered list item 1
2. Ordered list item 2
1. Nested ordered 2a
2. Nested ordered 2b
---
> Blockquote example
>> Nested blockquote
---
| Header 1 | Header 2 |
|----------|----------|
| Cell 1 | Cell 2 |
| Cell 3 | Cell 4 |

</Markdown>
C# Usage
var markdown = new Markdown
{
Text = "# Hello, Markdown!"
};
Documentation: https://docs.avaloniaui.net/controls/data-display/text-display/markdown
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Avalonia (>= 12.0.3)
- Avalonia.Controls.Documents (>= 12.2.0)
- Avalonia.Controls.Documents.Serialization.Html (>= 12.2.0)
- AvaloniaUI.Licensing (>= 3.1.1)
- Markdig.Signed (>= 1.0.0)
-
net8.0
- Avalonia (>= 12.0.3)
- Avalonia.Controls.Documents (>= 12.2.0)
- Avalonia.Controls.Documents.Serialization.Html (>= 12.2.0)
- AvaloniaUI.Licensing (>= 3.1.1)
- Markdig.Signed (>= 1.0.0)
NuGet packages (2)
Showing the top 2 NuGet packages that depend on Avalonia.Controls.Markdown:
| Package | Downloads |
|---|---|
|
Avalonia.Controls.Markdown.TextMate
Optional TextMate-based syntax highlighting integration for Avalonia.Controls.Markdown |
|
|
Avalonia.Controls.Markdown.ColorCode
Optional ColorCode-based syntax highlighting integration for Avalonia.Controls.Markdown |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 12.2.0 | 30 | 7/23/2026 |
| 12.1.5 | 7,630 | 6/29/2026 |
| 12.1.4 | 2,262 | 6/22/2026 |
| 12.1.3 | 607 | 6/9/2026 |
| 12.1.2 | 640 | 6/2/2026 |
| 12.1.1 | 1,035 | 5/14/2026 |
| 12.1.0 | 323 | 5/12/2026 |
| 12.0.0 | 4,163 | 4/7/2026 |
| 11.3.5 | 16,114 | 3/3/2026 |
| 11.3.4 | 4,423 | 12/4/2025 |
| 11.3.3 | 363 | 12/3/2025 |
| 11.3.2 | 705 | 11/24/2025 |
| 11.3.1 | 3,357 | 11/17/2025 |
| 11.3.0 | 1,224 | 10/13/2025 |
## 12.2.0
### Changes
- Markdown images now use the unified inline-image pipeline: `MarkdownImage`
derives from `RichImage` and renders through the shared image presenter, and
Markdown images snapshot as `ImageSnapshotNode` (carrying the URL as
`SourceUri`) so they round-trip through the unified serializers. Async URL
loading via `MarkdownImageLoader` (a style-injected extension point) is
preserved; `MarkdownImage`'s `ImageSource`/`ImageTitle`/`ImageLoader`
properties are unchanged. The internal `HtmlImage` render control and
`MarkdownImageData` record were removed, and the 2px `HtmlImage` theme margin
no longer applies.