Markdown Markdig Configuration

You can configure the Markdown Parser that is used in Help Builder which is MarkDig. You can configure the Markdown options used for this parser in the configuration settings in the wwhelp.config file in Documents\Html Help Builder Projects.

The setting is called <markdigextensions> and it takes a comma (or +) delimited list of the various available Markdig parsers. By default this value is empty in which case a default list is used:

<markdigextensions></markdigextensions>

You can configure specific extensions by using the Markdig named extension names which can be found in the Markdig Source code.

Help Builder's default list looks like this (all one line):

<markdigextensions>
advanced,pipetables,gridtables,emphasisextras,
listextras,attributes,citations,emojis,definitionlists,
customcontainers,figures,autoidentifiers,yaml,autolinks  
</markdigextensions>

Make sure you use Valid Names

If there's an invalid name in the list of extensions the Markdown parser will not work and your templates will fail. You will get an error message that lets you know which extension name is invalid and offers to reset the parser to its default settings.


© West Wind Techologies, 1996-2023 • Updated: 04/17/19
Comment or report problem with topic