DocFX输出到Markdown

Question

查看流程，DocFX似乎创建了.md文件，然后在创建文档时将其转换为html。

有没有办法使DocFX输出到.md文件而不是html？

Answer 1

更新：我应该在我最初的答案中误解这个问题。实际上，这仍然是DocFX的一个开放特性请求，这在当前的体系结构中是很难实现的。

请参阅：https://github.com/dotnet/docfx/issues/684

原始答案

您应该将.md文件从content移动到docfx.json中的resource。

以下面的docfx.json片段为例。在输出中，所有.md文件都将被转换为.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用户手册上找到。