Вывод DocFX в Markdown

Обновление: я должен неправильно понять этот вопрос в своем первоначальном ответе. На самом деле, это все еще открытый запрос функции DocFX, которого трудно достичь с текущей архитектурой.

См.: https://github.com/dotnet/docfx/issues/684.

Исходный ответ:

Вы должны переместить файлы .md из content в resource в docfx.json.

В качестве примера возьмем фрагмент кода docfx.json. Все файлы .md в articles будут преобразованы в .html на выходе.

...
"build": {
  "content": [
    {
      "files": ["articles/**.md"]
    }
  ]
}
...

Если вы надеетесь, что articles/sample.md останется непреобразованным, вы можете изменить docfx.json, как показано ниже:

...
"build": {
  "content": [
    {
      "files": ["articles/**.md"],
      "exclude": ["articles/sample.md"]
    }
  ]
  "resource": [
    {
      "files": ["articles/sample.md"]
    }
  ]
}
...

Дополнительную информацию можно найти на странице пользователя DocFX. Руководство.