How to activate a builtin markdig extension such as GenericAttributes ?

[tbolon]

Hi,

I have followed the markdown documentation but I can't find a way to activate the GenericAttributes extension.

I tried adding "GenericAttributes" or "GenericAttributesExtension" in my docfx.json in (markdownEngineProperties) without success:

    "markdownEngineProperties": {
      "markdigExtensions": [
        "GenericAttributes"
      ]
    } ,

DocumentException: Markup failed: Invalid extension `GenericAttributes` from `GenericAttributes` (Parameter
'extensions').
     DocumentException: Markup failed: Invalid extension `GenericAttributes` from `GenericAttributes` (Parameter
     'extensions').
          ArgumentException: Invalid extension `GenericAttributes` from `GenericAttributes` (Parameter 'extensions')
            at MarkdownPipelineBuilder Configure(MarkdownPipelineBuilder pipeline, string extensions)
            at MarkdownPipelineBuilder UseOptionalExtensions(MarkdownPipelineBuilder pipeline, IEnumerable<string>
               optionalExtensions) in MarkdownExtensions.cs:59
            at MarkdownPipeline CreateMarkdownPipeline(bool isInline, bool multipleYamlHeader) in
               MarkdigMarkdownService.cs:146
            at MarkupResult Markup(string content, string filePath, bool multipleYamlHeader) in
               MarkdigMarkdownService.cs:56
            at MarkupResult MarkupCore(string markdown, FileAndType ft, bool omitParse) in HostService.cs:90
       at MarkupResult MarkupCore(string markdown, FileAndType ft, bool omitParse) in HostService.cs:104
       at MarkupResult Markup(string markdown, FileAndType ft, bool omitParse) in HostService.cs:78
       at MarkupResult Markup(string markdown, FileAndType ft) in HostService.cs:73
...

I supposed the name to use should be the same as in the UseAdvancedExtensions method in MarkdownExtensions from Markdig?

How are we supposed to activate included extensions which are not activated by default?

[filzrev]

To activate GenericAttributes markdig extension.
It must specify attributes text as extension name.

https://github.com/xoofx/markdig/blob/391f376fa22b87494e308091d1b27be83e82f567/src/Markdig/MarkdownExtensions.cs#L597-L599

[tbolon]

Thank you! I missed this method when browsing code 😖

Perhaps the documentation could be updated to explain that the extension name should be one of these contained in this method.

[tbolon]

I created a PR : #9810