org.commonmark.ext.gfm.strikethrough

Class StrikethroughExtension

java.lang.Object

org.commonmark.ext.gfm.strikethrough.StrikethroughExtension

All Implemented Interfaces:

Extension, Parser.ParserExtension, HtmlRenderer.HtmlRendererExtension, TextContentRenderer.TextContentRendererExtension

public class StrikethroughExtension
extends Object
implements Parser.ParserExtension, HtmlRenderer.HtmlRendererExtension, TextContentRenderer.TextContentRendererExtension

Extension for GFM strikethrough using ~ or ~~ (GitHub Flavored Markdown).

Example input:

 ~foo~ or ~~bar~~

Example output (HTML):

 <del>foo</del> or <del>bar</del>

Create the extension with create() and then add it to the parser and renderer builders (Parser.Builder.extensions(Iterable), HtmlRenderer.Builder#extensions(Iterable)).

The parsed strikethrough text regions are turned into Strikethrough nodes.

If you have another extension that only uses a single tilde (~) syntax, you will have to configure this StrikethroughExtension to only accept the double tilde syntax, like this:

     
     StrikethroughExtension.builder().requireTwoTildes(true).build();
     
 

If you don't do that, there's a conflict between the two extensions and you will get an IllegalArgumentException when constructing the parser.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	StrikethroughExtension.Builder

Method Summary

Modifier and Type	Method and Description
static StrikethroughExtension.Builder	builder()
static Extension	create()
void	extend(HtmlRenderer.Builder rendererBuilder)
void	extend(Parser.Builder parserBuilder)
void	extend(TextContentRenderer.Builder rendererBuilder)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

create

public static Extension create()

Returns:

the extension with default options

builder

public static StrikethroughExtension.Builder builder()

Returns:

a builder to configure the behavior of the extension

extend

public void extend(Parser.Builder parserBuilder)

Specified by:

extend in interface Parser.ParserExtension

extend

public void extend(HtmlRenderer.Builder rendererBuilder)

Specified by:

extend in interface HtmlRenderer.HtmlRendererExtension

extend

public void extend(TextContentRenderer.Builder rendererBuilder)

Specified by:

extend in interface TextContentRenderer.TextContentRendererExtension