dualfrozandAlexandre Mutel
425c9f8a46
* fix: keep trailing content out of unmatched emphasis closer (#743) When EnableTrackTrivia() is enabled, an emphasis closer whose delimiter run is only partially consumed (its leftover dropping below the minimum count) kept the inlines that follow it nested inside the emphasis. The roundtrip renderer then emitted the closing delimiters after that trailing content, corrupting the output, for example a grid table separator row using the "marked" (==) delimiter from EmphasisExtras. Move the trailing content out to the outermost enclosing emphasis when the closer can no longer be matched, mirroring the existing handling for a fully consumed opener. The leftover closer keeps its position, so cases without trailing content are unaffected. Adds a regression test. * Fix unmatched emphasis closer cleanup order (#743) --------- Co-authored-by: Alexandre Mutel <alexandre_mutel@live.com>
2.0 KiB
title
| title |
|---|
| Emphasis extras |
Emphasis extras
Enable with .UseEmphasisExtras() (included in UseAdvancedExtensions()).
This extension adds several emphasis styles beyond standard bold and italic.
If you need improved emphasis parsing for Chinese/Japanese/Korean (CJK) text, see CJK friendly emphasis.
Strikethrough
Wrap text with ~~ for strikethrough:
This is ~~deleted~~ text.
This is deleted text.
Subscript
Wrap text with ~ for subscript:
H~2~O is water.
H2O is water.
Superscript
Wrap text with ^ for superscript:
2^10^ is 1024.
2^10^ is 1024.
Inserted text
Wrap text with ++ for inserted/underlined text:
This text has been ++inserted++.
This text has been ++inserted++.
Marked/highlighted text
Wrap text with == for marked/highlighted text:
This is ==highlighted== text.
This is ==highlighted== text.
An unmatched remainder of a closing delimiter run must not pull subsequent text
into the emphasis. For example, ===a===== tail renders as
=<mark>a===</mark> tail. This example also round-trips unchanged with
EnableTrackTrivia() and RoundtripRenderer.
HTML output
{.table}
| Syntax | HTML output |
|---|---|
~~text~~ |
<del>text</del> |
~text~ |
<sub>text</sub> |
^text^ |
<sup>text</sup> |
++text++ |
<ins>text</ins> |
==text== |
<mark>text</mark> |
Selective activation
By default, all emphasis extras are enabled. Use EmphasisExtraOptions to enable only specific ones:
using Markdig.Extensions.EmphasisExtras;
var pipeline = new MarkdownPipelineBuilder()
.UseEmphasisExtras(EmphasisExtraOptions.Strikethrough | EmphasisExtraOptions.Superscript)
.Build();
Available options:
EmphasisExtraOptions.StrikethroughEmphasisExtraOptions.SubscriptEmphasisExtraOptions.SuperscriptEmphasisExtraOptions.InsertedEmphasisExtraOptions.MarkedEmphasisExtraOptions.Default(all of the above)