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 片段为例。 articles 中的所有.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 User Manual 上找到.