docfx - DocFX 输出到 Markdown

Question

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

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

Answer 1

更新：我应该在我原来的答案中误解了这个问题。实际上，这仍然是 DocFX 的一个开放功能要求，以目前的架构很难实现。

见：https ://github.com/dotnet/docfx/issues/684

---

原始答案：

您应该将 .md 文件从 移动content到resourcein 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 用户手册中找到。