如何用dartdoc 6.1.2生成Markdown文档？原5.1.2命令失效

dartdoc 6.x版本已移除原生支持Markdown输出的功能，原有的--format选项被删除，这就是你执行命令时提示找不到该选项的原因。以下是两种可行的解决办法：

方法一：使用第三方Markdown生成工具 #

可以借助dartdoc_markdown包生成Markdown格式文档，步骤如下：

1. 全局激活该包：

dart pub global activate dartdoc_markdown

2. 在项目根目录执行生成命令：

dart pub global run dartdoc_markdown

工具会读取项目的dartdoc注释，将Markdown文档默认生成到doc/api目录下。

方法二：降级回dartdoc 5.x版本 #

如果需要临时使用原生Markdown生成功能，可降级到dartdoc 5.1.2版本：

1. 全局安装指定版本：

dart pub global activate dartdoc 5.1.2

2. 执行原有生成命令即可：

dart doc --format md

注意：降级后会缺失dartdoc 6.x的新特性，建议仅作为临时方案使用。

另外，你之前尝试的命令dart doc . -- formar md存在拼写错误，正确写法应为dart doc . --format md，但该命令仅在dartdoc 5.x版本中有效。

内容的提问来源于stack exchange，提问作者ttt