Oakrey.Markdown 1.0.1

dotnet add package Oakrey.Markdown --version 1.0.1
                    
NuGet\Install-Package Oakrey.Markdown -Version 1.0.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Oakrey.Markdown" Version="1.0.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Oakrey.Markdown" Version="1.0.1" />
                    
Directory.Packages.props
<PackageReference Include="Oakrey.Markdown" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Oakrey.Markdown --version 1.0.1
                    
#r "nuget: Oakrey.Markdown, 1.0.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#addin nuget:?package=Oakrey.Markdown&version=1.0.1
                    
Install Oakrey.Markdown as a Cake Addin
#tool nuget:?package=Oakrey.Markdown&version=1.0.1
                    
Install Oakrey.Markdown as a Cake Tool

Oakrey.Markdown

Overview

The "Markdown" project provides a framework for parsing, processing, and rendering Markdown content in .NET applications. It supports advanced Markdown features, including tables, code blocks, images, and text decorations, and integrates seamlessly with WPF for rendering styled Markdown content.

Feature

Markdown Parsing:

  • MarkdownProcessor: Core class for transforming Markdown text into WPF FlowDocument objects.
  • Supports block-level and inline-level parsing using a modular parser architecture.

Advanced Markdown Features:

  • Tables (MdTables, MdTableCell, MdTable).
  • Code blocks with or without language specification (MdCodeBlocks).
  • Headers, blockquotes, lists, and rules (MdHeader, MdBlockquotes, MdList, MdRule).
  • Inline elements like images and text decorations (MdImage, MdTextDecoration).

Customizable Styles:

  • MarkdownProcessor.Style.xaml: Provides WPF styles for rendering Markdown content.
  • DocumentStyle property allows customization of the rendered FlowDocument.

Emoji and Text Utilities:

  • EmojiTable: Supports rendering emojis in Markdown.
  • TextUtilities: Normalizes and processes text for consistent rendering.

Extensibility:

  • Modular parser design with interfaces like IBlockParser and IInlineParser.
  • Custom parsers can be added for additional Markdown features.

WPF Integration:

  • MarkdownScrollViewer: A WPF control for displaying Markdown content.
  • Leverages WPF's FlowDocument for rich text rendering.

Assets and Resources:

Includes syntax highlighting definitions (XmlDefinition.xshd) and emoji support (EmojiTable.txt).

Installation

You can install the package via NuGet Package Manager, Package Manager Console or the .NET CLI.

NuGet Package Manager

  1. Open your project in Visual Studio.
  2. Navigate to Tools > NuGet Package Manager > Manage NuGet Packages for Solution....
  3. Search for Oakrey.Markdown and click Install.

.NET CLI

Run the following command in your terminal:

dotnet add package Oakrey.Markdown

Package Manager Console

Run the following command in your Package Manager Console:

Install-Package Oakrey.Markdown

Requirements

  • .NET 8 or higher

Project Information

Contributing

Contributions are welcome! Feel free to open issues or submit pull requests to improve the package.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Product Compatible and additional computed target framework versions.
.NET net8.0-windows7.0 is compatible.  net9.0-windows was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.1 193 4/17/2025
1.0.0 175 4/16/2025