# Configuration

SpannableConfiguration is the core component that controls how markdown is parsed and rendered. It can be obtained via factory methods:

// creates default implementation
final SpannableConfiguration configuration = SpannableConfiguration.create(context);

// creates configurablable instance via `#builder` method
final SpannableConfiguration configuration = SpannableConfiguration.builder(context)
        .asyncDrawableLoader(AsyncDrawableLoader.create())
        .build();

# Theme

SpannableTheme controls how markdown is rendered. It has pretty extensive number of options that can be found here

SpannableConfiguration.builder(context)
        .theme(SpannableTheme)
        .build();

If SpannableTheme is not provided explicitly, SpannableTheme.create(context) will be used

# Images

# Async loader

AsyncDrawable.Loader handles images in your markdown and HTML

SpannableConfiguration.builder(context)
        .asyncDrawableLoader(AsyncDrawable.Loader)
        .build();

If AsyncDrawable.Loader is not provided explicitly, default no-op implementation will be used.

# Size resolver 1.0.1

ImageSizeResolver controls the size of an image to be displayed. Currently it handles only HTML images (specified via img tag).

SpannableConfiguration.builder(context)
        .imageSizeResolver(ImageSizeResolver)
        .build();

If not provided explicitly, default ImageSizeResolverDef implementation will be used. It handles 3 dimention units:

• % (percent)
• em (relative to text size)
• px (absolute size, every dimention that is not % or em is considered to be absolute)

<img width="100%">
<img width="2em" height="10px">
<img style="{width: 100%; height: 8em;}">

ImageSizeResolverDef keeps the ratio of original image if one of the dimentions is missing.

# Syntax highlight

SyntaxHighlight controls the syntax highlight for code blocks (in markdown).

SpannableConfiguration.builder(context)
        .syntaxHighlight(SyntaxHighlight)
        .build();

If not provided explicitly, default no-op implementation will be used.

# Link resolver

LinkSpan.Resolver is triggered when a link is clicked in markdown/HTML.

SpannableConfiguration.builder(context)
        .linkResolver(LinkSpan.Resolver)
        .build();

If not provided explicitly, default LinkResolverDef implementation will be used. Underneath it constructs an Intent and tries to start an Activity associated with it. It no Activity is found, it will silently fail (no runtime exceptions)

# URL processor

UrlProcessor is used to process found URLs in markdown/HTML.

SpannableConfiguration.builder(context)
        .urlProcessor(UrlProcessor)
        .build();

If not provided explicitly, default no-op implementation will be used.

Markwon provides 2 implementations of UrlProcessor:

• UrlProcessorRelativeToAbsolute
• UrlProcessorAndroidAssets

# UrlProcessorRelativeToAbsolute

UrlProcessorRelativeToAbsolute can be used to make relative URL absolute. For example if an image is defined like this: ![img](./art/image.JPG) and UrlProcessorRelativeToAbsolute is created with https://github.com/noties/Markwon/raw/master/ as the base: new UrlProcessorRelativeToAbsolute("https://github.com/noties/Markwon/raw/master/"), then final image will have https://github.com/noties/Markwon/raw/master/art/image.JPG as the destination.

# UrlProcessorAndroidAssets

UrlProcessorAndroidAssets can be used to make processed links to point to Android assets folder. So an image: ![img](./art/image.JPG) will have file:///android_asset/art/image.JPG as the destination

# Factory 1.1.0

SpannableFactory is used to control what span implementations to be used

SpannableConfiguration.builder(context)
        .factory(SpannableFactory)
        .build();

If not provided explicitly, default SpannableFactoryDef implementation will be used. It is documented in this section

# Soft line break 1.1.1

softBreakAddsNewLine option controls how soft breaks are treated in the final result. If true -> soft break will add a new line, else it will add a (space) char.

SpannableConfiguration.builder(context)
        .softBreakAddsNewLine(boolean)
        .build();

If not provided explicitly, default false value will be used.

# HTML 2.0.0

# Parser

MarkwonHtmlParser is used to parse HTML content

SpannableConfiguration.builder(context)
        .htmlParser(MarkwonHtmlParser)
        .build();

if not provided explicitly, default MarkwonHtmlParserImpl will be used if it can be found in classpath, otherwise default no-op implementation wiil be used. Refer to HTML document for more information about this behavior.

# Renderer

MarkwonHtmlRenderer controls how parsed HTML content will be rendered.

SpannableConfiguration.builder(context)
        .htmlRenderer(MarkwonHtmlRenderer)
        .build();

If not provided explicitly, default MarkwonHtmlRenderer implementation will be used. It is documented here

# HTML allow non-closed tags

htmlAllowNonClosedTags option is used to control whether or not to render non-closed HTML tags

SpannableConfiguration.builder(context)
        .htmlAllowNonClosedTags(boolean)
        .build();

If not provided explicitly, default value false will be used (non-closed tags won't be rendered).