DocFX输出到Markdown

Question

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

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

Answer 1

更新：我应该在原来的答案中误解这个问题。实际上，这仍然是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 User Manual找到更多信息。