MarkdownTextBlock XAML Control

The MarkdownTextBlock control provides full markdown parsing and rendering for Universal Windows Apps. Originally created for the open source reddit app Baconit, the control was engineered to be simple to use and very efficient. One of the main design considerations for the control was it needed to be performant enough to provide a great user experience in virtualized lists. With the custom markdown parser and efficient XAML rendering, we were able to achieve excellent performance; providing a smooth UI experience even with complex Markdown on low end hardware.

Under the hood, the control uses XAML sub elements to build the visual rendering tree for the Markdown input. We chose to use full XAML elements over using the RichEditTextBlock control because the RichEditTextBlock isn’t flexible enough to correctly render all of the standard Markdown styles.


    Text="**This is *Markdown*!"


Here are some limitations you may encounter:

  • Images cannot be embedded inside a hyperlink
  • All images are stretched with the same stretch value (defined by ImageStretch property)

Example Image

Note: scrolling is smooth, the gif below is not.

MarkdownTextBlock animation


The MarkdownTextBlock control is highly customizable to blend with any theme. Customizable properties include:

  • IsTextSelectionEnabled
  • CodeBackground
  • CodeBorderBrush
  • CodeBorderThickness
  • CodeForeground
  • CodeFontFamily
  • CodeMargin
  • CodePadding
  • Header1FontWeight
  • Header1FontSize
  • Header1Margin
  • Header2FontWeight
  • Header2FontSize
  • Header2Margin
  • Header3FontWeight
  • Header3FontSize
  • Header3Margin
  • Header4FontWeight
  • Header4FontSize
  • Header4Margin
  • Header5FontWeight
  • Header5FontSize
  • Header5Margin
  • Header6FontWeight
  • Header6FontSize
  • Header6Margin
  • HorizontalRuleBrush
  • HorizontalRuleMargin
  • HorizontalRuleThickness
  • ListMargin
  • ListGutterWidth
  • ListBulletSpacing
  • ParagraphMargin
  • QuoteBackground
  • QuoteBorderBrush
  • QuoteBorderThickness
  • QuoteForeground
  • QuoteMargin
  • QuotePadding
  • TableBorderBrush
  • TableBorderThickness
  • TableCellPadding
  • TableMargin
  • TextWrapping

Example Code

MarkdownTextBlock Sample Page

Default Template

MarkdownTextBlock XAML File is the XAML template used in the toolkit for the default styling.

Requirements (Windows 10 Device Family)

Device family Universal, 10.0.10586.0 or higher
Namespace Microsoft.Toolkit.Uwp.UI.Controls