MarkdownToXamlConverter.Maui 0.0.1

MarkdownToXaml.Maui

MarkdownToXaml.Maui is a .NET library that converts a limited Markdown subset into .NET MAUI-compatible XAML fragments for use in multi-platform MAUI apps.

It is the MAUI library counterpart to the converter used in the API project.

Features

• Convert Markdown into a MAUI XAML fragment
• Return metadata such as unsupported lines, notes, and plain-text preview
• Expose a compact MDtoXamlConverter API for fragment-focused usage
• Build as a plain net8.0 library by default, or opt into platform-specific MAUI target frameworks when needed

Supported Markdown

• Headings: # through ######
• Paragraphs
• Bold: **text** and __text__
• Italic: *text* and _text_
• Unordered lists: -, *, +
• Ordered lists: 1., 2., 3.
• Task items: - [x] done, - [ ] todo

Current limitations

These inputs are currently treated as unsupported and rendered as plain labels:

• Blockquotes
• Fenced code blocks
• Tables

Project layout

• Services/MarkdownToXamlConverter.cs - conversion engine for MAUI XAML fragments
• Services/MDtoXamlConverter.cs - compact facade for Markdown-to-fragment workflows
• Models/MarkdownConversionResult.cs - result payload returned by the converter

Usage

Convert to XAML

using MarkdownToXaml.Maui.Services;

var converter = new MDtoXamlConverter();

var result = converter.Convert(
    "# Hello\nThis is **bold** and *italic*.\n- [x] Ship it",
    "Preview");

var xamlFragment = result.Xaml;
var previewText = result.PreviewPlainText;

Convert to a fragment string directly

using MarkdownToXaml.Maui.Services;

var converter = new MDtoXamlConverter();

var xamlFragment = converter.ConvertToFragment(
    "# Release Notes\n- First item\n- Second item",
    "Build 42");

Example output

Calling Convert(...) returns a MarkdownConversionResult with:

• Xaml - generated VerticalStackLayout fragment
• UnsupportedLines - lines that are not fully supported
• Notes - informational notes about supported syntax
• PreviewPlainText - simplified plain-text preview

Build

Build the cross-platform library target:

dotnet build MarkdownToXaml.Maui/MarkdownToXaml.Maui.csproj

Build and pack a NuGet package:

dotnet pack MarkdownToXaml.Maui/MarkdownToXaml.Maui.csproj -c Package

Opt into platform-specific MAUI target frameworks when needed:

dotnet build MarkdownToXaml.Maui/MarkdownToXaml.Maui.csproj -p:BuildMauiPlatforms=true

Notes for .NET 8 builds

The default target is net8.0, which keeps the package broadly usable and easy to test on any host. If you pass -p:BuildMauiPlatforms=true, the project also includes net8.0-android and host-supported Apple or Windows MAUI targets.