class markdown::HtmlRendererBuilder
sys::Obj markdown::HtmlRendererBuilder
@Js
Builder for configuring an HtmlRenderer
.
- attrProviderFactory
-
This attrProviderFactory(|HtmlContext->AttrProvider| factory)
Add a factory for an attribute provider for adding/changing HTML attributes to the rendered tags.
- build
-
HtmlRenderer build()
Get the configured
HtmlRenderer
- extensions
-
This extensions(MarkdownExt[] exts)
Configure the given extensions on this this renderer
- nodeRendererFactory
-
This nodeRendererFactory(|HtmlContext->NodeRenderer| factory)
Add a factory for instantiating a node renderer (done when rendering). This allows to override the rendering of node types or define rendering for custom node types.
If multiple node renderers for the same node type are created, the one from the factory that was added first "wins". (This is how rendering for core node types can be overriden; the default rendering comes last).
- withEscapeHtml
-
This withEscapeHtml(Bool val := true)
Whether
HtmlInline
andHtmlBlock
should be escaped, defaults tofalse
.Note that
HtmlInline
is only a tag itself, not the text between an opening tag and closing tag. So markup in the text will be parsed as normal and is not affected by this option. - withOmitSingleParagraphP
-
This withOmitSingleParagraphP(Bool val := true)
Whether documents that only contain a single paragraph shoudl be rendered without the
<p>
tag. Set totrue
to render without the tag; the default offalse
always renders the tag. - withPercentEncodeUrls
-
This withPercentEncodeUrls(Bool val := true)
Whether URLs of link or images should be percent-encoded, defaults to
false
.If enabled, the following is done:
- Existing percent-encoded parts are preserved (e.g. "%20" is kept as "%20")
- Reserved characters such as "/" are preserved, except for "[" and "]" (see encodeURL in JS).
- Other characters such as umlauts are percent-encoded
- withSanitizeUrls
-
This withSanitizeUrls(Bool val := true)
Whether
Image
src andLink
href should be sanitized, defaults tofalse
. - withSoftBreak
-
The HTML to use for rendering a softbreak, default to
\n
(meaning the rendered result doesn't have a line break).Set it to
<br>
or<br />
to make the hard breaks.Set it to