Markdig.Signed 0.37.0

Prefix Reserved
dotnet add package Markdig.Signed --version 0.37.0                
NuGet\Install-Package Markdig.Signed -Version 0.37.0                
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="Markdig.Signed" Version="0.37.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Markdig.Signed --version 0.37.0                
#r "nuget: Markdig.Signed, 0.37.0"                
#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.
// Install Markdig.Signed as a Cake Addin
#addin nuget:?package=Markdig.Signed&version=0.37.0

// Install Markdig.Signed as a Cake Tool
#tool nuget:?package=Markdig.Signed&version=0.37.0                

Markdig Build Status Coverage Status NuGet Donate

<img align="right" width="160px" height="160px" src="img/markdig.png">

Markdig is a fast, powerful, CommonMark compliant, extensible Markdown processor for .NET.

NOTE: The repository is under construction. There will be a dedicated website and proper documentation at some point!

You can try Markdig online and compare it to other implementations on babelmark3

Features

If you are looking for support for an old .NET Framework 3.5 or 4.0, you can download Markdig 0.18.3.

Third Party Extensions

Documentation

The repository is under construction. There will be a dedicated website and proper documentation at some point!

While there is not yet a dedicated documentation, you can find from the specs documentation how to use these extensions.

In the meantime, you can have a "behind the scene" article about Markdig in my blog post "Implementing a Markdown Engine for .NET"

Download

Markdig is available as a NuGet package: NuGet

Also Markdig.Signed NuGet package provides signed assemblies.

Usage

The main entry point for the API is the Markdig.Markdown class:

By default, without any options, Markdig is using the plain CommonMark parser:

var result = Markdown.ToHtml("This is a text with some *emphasis*");
Console.WriteLine(result);   // prints: <p>This is a text with some <em>emphasis</em></p>

In order to activate most of all advanced extensions (except Emoji, SoftLine as HardLine, Bootstrap, YAML Front Matter, JiraLinks and SmartyPants)

// Configure the pipeline with all advanced extensions active
var pipeline = new MarkdownPipelineBuilder().UseAdvancedExtensions().Build();
var result = Markdown.ToHtml("This is a text with some *emphasis*", pipeline);

Try it online!

You can have a look at the MarkdownExtensions that describes all actionable extensions (by modifying the MarkdownPipeline)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated. For detailed contributing guidelines, please see contributing.md.

Build

In order to build Markdig, you need to install .NET 6.0

License

This software is released under the BSD-Clause 2 license.

Benchmarking

The latest benchmark was collected on April 23 2022, against the following implementations:

  • Markdig (version: 0.30.2): itself
  • cmark (version: 0.30.2): Reference C implementation of CommonMark, no support for extensions
  • CommonMark.NET(master) (version: 0.15.1): CommonMark implementation for .NET, no support for extensions, port of cmark, deprecated.
  • MarkdownSharp (version: 2.0.5): Open source C# implementation of Markdown processor, as featured previously on Stack Overflow, regexp based.
// * Summary *

BenchmarkDotNet=v0.13.1, OS=Windows 10.0.22000
AMD Ryzen 9 5950X, 1 CPU, 32 logical and 16 physical cores
.NET SDK=6.0.202
  [Host]     : .NET 6.0.4 (6.0.422.16404), X64 RyuJIT
  DefaultJob : .NET 6.0.4 (6.0.422.16404), X64 RyuJIT


|            Method |       Mean |     Error |    StdDev |
|------------------ |-----------:|----------:|----------:|
|           markdig |   1.979 ms | 0.0221 ms | 0.0185 ms |
|             cmark |   2.571 ms | 0.0081 ms | 0.0076 ms |
|    CommonMark.NET |   2.016 ms | 0.0169 ms | 0.0158 ms |
|     MarkdownSharp | 221.455 ms | 1.4442 ms | 1.3509 ms |
  • Markdig is roughly x100 times faster than MarkdownSharp
  • 20% faster than the reference cmark C implementation

If you are using this library and find it useful for your project, please consider a donation for it!

Donate

Credits

Thanks to the fantastic work done by John Mac Farlane for the CommonMark specs and all the people involved in making Markdown a better standard!

This project would not have been possible without this huge foundation.

Thanks also to the project BenchmarkDotNet that makes benchmarking so easy to setup!

Some decoding part (e.g HTML EntityHelper.cs) have been re-used from CommonMark.NET

Thanks to the work done by @clarkd on the JIRA Link extension (https://github.com/clarkd/MarkdigJiraLinker), now included with this project!

Author

Alexandre MUTEL aka xoofx

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  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. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 is compatible. 
.NET Framework net461 was computed.  net462 is compatible.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETFramework 4.6.2

  • .NETStandard 2.0

  • .NETStandard 2.1

    • No dependencies.
  • net6.0

    • No dependencies.
  • net8.0

    • No dependencies.

NuGet packages (57)

Showing the top 5 NuGet packages that depend on Markdig.Signed:

Package Downloads
Microsoft.PowerShell.Commands.Utility

Runtime for hosting PowerShell

Microsoft.PowerShell.MarkdownRender

MarkdownRenderer for PowerShell

Microsoft.Quantum.Compiler

The Q# compiler.

Soneta.Types

Składnik programu Soneta. Program obsługi firmy: kadry-płace, księgowość, handel, magazyn, CRM, BI ...

Microsoft.Quantum.CSharpGeneration

C# code generation for executing Q# programs on a quantum simulator.

GitHub repositories (22)

Showing the top 5 popular GitHub repositories that depend on Markdig.Signed:

Repository Stars
microsoft/PowerToys
Windows system utilities to maximize productivity
PowerShell/PowerShell
PowerShell for every system!
abpframework/abp
Open-source web application framework for ASP.NET Core! Offers an opinionated architecture to build enterprise software solutions with best practices on top of the .NET. Provides the fundamental infrastructure, cross-cutting-concern implementations, startup templates, application modules, UI themes, tooling and documentation.
JustArchiNET/ArchiSteamFarm
C# application with primary purpose of farming Steam cards from multiple accounts simultaneously.
microsoft/fluentui-blazor
Microsoft Fluent UI Blazor components library. For use with ASP.NET Core Blazor applications
Version Downloads Last updated
0.37.0 135,684 4/9/2024
0.36.2 24,360 3/14/2024
0.36.1 211 3/14/2024
0.36.0 558 3/14/2024
0.35.0 19,583 2/17/2024
0.34.0 55,050 12/14/2023
0.33.0 1,110,780 8/30/2023
0.32.0 28,578 8/4/2023
0.31.0 1,335,913 2/27/2023
0.30.4 1,071,314 9/27/2022
0.30.3 40,070 8/12/2022
0.30.2 119,124 4/23/2022
0.30.1 1,546 4/22/2022
0.30.0 1,954 4/21/2022
0.29.0 2,692 4/20/2022
0.28.1 14,981 3/27/2022
0.28.0 5,881 3/11/2022
0.27.0 38,138 1/23/2022
0.26.0 276,279 8/27/2021
0.25.0 29,679 6/10/2021
0.24.0 31,572 3/20/2021
0.23.0 66,238 1/16/2021
0.22.1 375,516 12/2/2020
0.22.0 1,940,401 10/5/2020
0.21.1 1,476,903 8/17/2020
0.20.0 696,734 4/18/2020
0.18.3 1,017,050 3/8/2020
0.18.2 718 3/8/2020
0.18.1 204,004 1/21/2020
0.18.0 165,341 10/24/2019
0.17.1 964,993 7/4/2019
0.17.0 333,555 5/11/2019
0.16.0 167,589 2/25/2019
0.15.7 136,353 1/11/2019
0.15.6 224,951 12/28/2018
0.15.5 3,427 12/11/2018
0.15.4 240,251 10/7/2018
0.15.3 3,345 9/26/2018
0.15.2 149,360 8/21/2018
0.15.1 498,072 7/10/2018
0.15.0 2,786 4/4/2018
0.14.9 13,998 1/15/2018
0.14.8 4,710 12/5/2017
0.14.7 1,117 11/25/2017
0.14.6 1,312 11/21/2017
0.14.5 1,332 11/18/2017
0.14.4 1,283 11/18/2017
0.14.3 2,442 11/1/2017
0.14.2 1,293 11/1/2017
0.14.1 1,307 10/27/2017
0.14.0 1,284 10/27/2017
0.13.4 1,338 10/17/2017
0.13.3 23,951 8/30/2017
0.13.2 1,112 8/29/2017
0.13.1 1,115 8/21/2017
0.13.0 13,456 8/3/2017
0.12.4 2,377 8/3/2017