2016-06-16 12:26:28 +09:00
2016-06-16 12:24:01 +09:00
2016-02-10 00:12:40 +09:00
2016-02-10 00:12:40 +09:00
2016-06-16 12:26:28 +09:00

Markdig Build status NuGet

Markdig is a fast, powerfull, 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

Download

Markdig is available as a NuGet package: NuGet

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 HarLine 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);

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

License

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

Benchmarking

This is an early preview of the benchmarking against various implementations:

C implementations:

  • cmark: Reference C implementation of CommonMark, no support for extensions
  • Moonshine: popular C Markdown processor

.NET implementations:

JavaScript/V8 implementations:

Analysis of the results:

  • Markdig is roughly x100 times faster than MarkdownSharp
  • Among the best in CPU, Extremelly competitive and often faster than other implementations (not feature wise equivalent)
  • 15% to 30% less allocations and GC pressure

Because Marked.NET and MarkdownSharp are way too slow, we couldn't include them in the following charts:

BenchMark CPU Time

BenchMark Memory

Performance in x86:

BenchmarkDotNet-Dev=v0.9.7.0+
OS=Microsoft Windows NT 6.2.9200.0
Processor=Intel(R) Core(TM) i7-4770 CPU 3.40GHz, ProcessorCount=8
Frequency=3319351 ticks, Resolution=301.2637 ns, Timer=TSC
HostCLR=MS.NET 4.0.30319.42000, Arch=32-bit RELEASE
JitModules=clrjit-v4.6.1080.0

Type=Program  Mode=SingleRun  LaunchCount=2
WarmupCount=2  TargetCount=10

                     Method |      Median |    StdDev |Scaled | Gen 0  | Gen 1 | Gen 2  |Bytes Allocated/Op |
--------------------------- |------------ |---------- |------ |------  |------ |------  |------------------ |
                    Markdig |   5.5316 ms | 0.0372 ms |  0.71 |  56.00 | 21.00 |  49.00 |      1,285,917.31 |
     CommonMark.NET(master) |   4.7035 ms | 0.0422 ms |  0.60 | 113.00 |  7.00 |  49.00 |      1,502,404.60 |
CommonMark.NET(pipe_tables) |   5.6164 ms | 0.0298 ms |  0.72 | 111.00 | 56.00 |  49.00 |      1,863,128.13 |
               MarkdownDeep |   7.8193 ms | 0.0334 ms |  1.00 | 120.00 | 56.00 |  49.00 |      1,884,854.85 |
                      cmark |   4.2698 ms | 0.1526 ms |  0.55 |      - |     - |      - |                NA |
                  Moonshine |   6.0929 ms | 0.1053 ms |  1.28 |      - |     - |      - |                NA |
                  Strike.V8 |  10.5895 ms | 0.0492 ms |  1.35 |      - |     - |      - |                NA |
                 Marked.NET | 207.3169 ms | 5.2628 ms | 26.51 |  0.00  |  0.00 |  0.00  |    303,125,228.65 |
              MarkdownSharp | 675.0185 ms | 2.8447 ms | 86.32 | 40.00  | 27.00 | 41.00  |      2,413,394.17 |

Performance for x64:

BenchmarkDotNet-Dev=v0.9.6.0+
OS=Microsoft Windows NT 6.2.9200.0
Processor=Intel(R) Core(TM) i7-4770 CPU @ 3.40GHz, ProcessorCount=8
Frequency=3319351 ticks, Resolution=301.2637 ns, Timer=TSC
HostCLR=MS.NET 4.0.30319.42000, Arch=64-bit RELEASE [RyuJIT]
JitModules=clrjit-v4.6.1080.0

Type=Program  Mode=SingleRun  LaunchCount=2
WarmupCount=2  TargetCount=10

               Method |    Median |    StdDev |  Gen 0 |  Gen 1 | Gen 2 | Bytes Allocated/Op |
--------------------- |---------- |---------- |------- |------- |------ |------------------- |
          TestMarkdig | 5.5276 ms | 0.0402 ms | 109.00 |  96.00 | 84.00 |       1,537,027.66 |
    TestCommonMarkNet | 4.4661 ms | 0.1190 ms | 157.00 |  96.00 | 84.00 |       1,747,432.06 |
 TestCommonMarkNetNew | 5.3151 ms | 0.0815 ms | 229.00 | 168.00 | 84.00 |       2,323,922.97 |
     TestMarkdownDeep | 7.4076 ms | 0.0617 ms | 318.00 | 186.00 | 84.00 |       2,576,728.69 |

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

Author

Alexandre MUTEL aka xoofx

Description
No description provided
Readme 9.1 MiB
Latest
2026-02-10 06:11:01 +00:00
Languages
C# 99.9%