Docfx: Support configuration for Markdig built-in extensions

[usigrist]

DocFX Version Used: 2.39.1

Is there a way to use grid tables by enabling the markdig Grid Table extension when using the markdig engine?

[herohua]

@yishengjin1413 @wh-alice

[usigrist]

Could this be done using the Property markdownEngineProperties in docfx.json with a new key and a list of native markdig extensions to be added during pipeline initialization?
If yes I could implement it and provide a pull request.

[superyyrrzz]

It sounds good to me. @Thraka also want this extension (https://github.com/dotnet/docfx/issues/4201#issuecomment-474636674) and may like this idea.

@yishengjin1413 @wh-alice What do you think of this? I know docfx has some custom Markdig extension. My only concern is whether it will cause some conflict if we allow users to choose extensions.

[yishengjin1413]

@usigrist Sounds good. And I suggest you to add one method like builder.UseCustomExtensions(_context, config) in L143 before builder.UseDocfxExtensions(_context) . Since some extensions are added by order in DocfxExtensions.

[superyyrrzz]

Markdig also supports footnotes for #1564

[Thraka]

I would love this.

[sommmen]

Any update on footnote support?

[smokedlinq]

Hey @docs-product or someone else, will be this something we can look forward to in v3?

[cillroy]

we are evaluating this and looking into the impact on our design team

[tibel]

Enabling markdig Diagrams would be great too.

[lionelberton]

Enabling markdig Math formulas would be great too

[simonziegler]

I'm also keen to see footnotes, diagrams and maths formulae at some time.

[wangkanai]

Any progress regarding this issue? Its would make DocFX features extendibility top out everything.

[Himura2la]

I was surprised when I found out that it's not possible at the moment. Although there are some concerns on compatibility. In particular: Where how should the footnote descriptions be placed if they are in API or in an included file?