dart doc 是否支持生成 markdown 而不是 HTML？

Question

我有 dart doc . 工作和生成 HTML 文件。

我想改为生成 Markdown 文件。

谷歌搜索时，我找到了这个答案https://github.com/dart-lang/dartdoc/issues/1479#issuecomment-868961953 - 这让我找到了这个 PR：https://github.com/dart-lang/dartdoc/pull/2703

在差异 https://github.com/dart-lang/dartdoc/pull/2703/files - 我看到 format 和 md - 但我是新手，所以我不知道如何使用此信息来创建我需要使用的命令。

我期待像 dart doc . --format md 这样的东西可以工作，但它没有。

此外，当我运行 dart doc --help 时，它会引导我到这里：https://dart.dev/go/dartdoc-options-file - 它没有提到在 Markdown 中生成文档的能力。

也许这不受支持？ TY

Answer 1

dart doc 无法创建 markdown 格式的文档，你必须使用包 dartdoc（参见 https://github.com/dart-lang/dartdoc/issues/3241#issuecomment-1302150336）

您必须运行dart pub global run dartdoc --format=md（但生成的md可能不是纯md，请参阅https://github.com/dart-lang/dartdoc/issues/3237）。