Renze Yu

You can provide an xref map to docfx to overwrite this default behavior. But you are right, there is no available config to switch it right now.

When resolving an xref, docfx should [read from xrefmap](https://github.com/dotnet/docfx/blob/dev/src/Microsoft.DocAsCode.Build.Engine/DocumentBuildContext.cs#L544) first, then [query xref](https://github.com/dotnet/docfx/blob/3c529e22a5d4dc77d2fda2972e40d14a6c377555/src/Microsoft.DocAsCode.Build.Engine/DocumentBuildContext.cs#L563) service.

Thank you for the information. I think this name should be already there with information extracted from Roslyn. I cannot think of an easy workaround for now.

@kdawg1406 This may help: https://github.com/dotnet/docfx/issues/1254#issuecomment-294080535

Sorry for late response... There must be some bug in the logic to fetch the file. You could try to work around this issue by changing the file name first.

Hinted by #1253 , we can add a post step (Maybe [a PostProcessor](https://dotnet.github.io/docfx/tutorial/howto_add_a_customized_post_processor.html)) to convert HTML pages to Markdown files.

@dkmiller Thank you for the info! Related doc: https://docs.microsoft.com/en-us/azure/devops/release-notes/2017/nov-28-vsts#wiki-supports-mathematical-formulas Actually, this is supported on docs.microsoft.com. We can see [some page using it](https://review.docs.microsoft.com/en-us/dotnet/api/microsoft.ml.trainers.lbfgsmaximumentropymulticlasstrainer?view=ml-dotnet&branch=smoke-test-preview#scoring-function). I will mark this feature as DocsParity for...

@bryancostanich According to our [roadmap](https://github.com/dotnet/docfx/blob/dev/Roadmap.md), v2 will not support `watch`, and v3 will. Does [DocFX preview plugin](https://marketplace.visualstudio.com/items?itemName=ms-docfx.DocFX#review-details) help?

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 also supports footnotes for #1564