User Guide

This guide explains how application developers consume ProMarkdown. It starts with the MarkdownTextBlock control, then moves through rendering configuration, source-aware editing, hit testing, theming, and extension points.

Core package

Install ProMarkdown for the control and the core parsing, rendering, editing, selection, layout, theme, and hit-testing services. The default control configuration is enough for common Markdown documents.

Optional features

Plugin packages are opt-in. Registration is explicit so applications control syntax, rendering behavior, editor selection, startup cost, and transitive dependencies.

Advanced composition

The public service contracts let applications render outside the stock control, map rendered content back to source, provide custom editor surfaces, or introduce new Markdown syntax and visuals.

Guide map

MarkdownTextBlock covers the primary control and its lifecycle.
Image Loading and Security configures source policies, resource limits, cancellation, and custom loaders.
Rendering Services configures core and plugin-aware pipelines.
Source-Aware Editing explains editor sessions and persisted updates.
Source Mapping and Hit Testing connects rendered content to source.
Theming configures semantic light, dark, and custom palettes.
Interactive Task Lists persists checkbox changes safely.
Plugin Ecosystem introduces optional packages and extension points.