是否使用rustdoc生成markdown文档？

Question

有没有办法在doc/中从///注释生成单个标记文件？

多个标记文件(doc/main.md、doc/foo.md等)也很好。

我是rust的新手，虽然生成的HTML文档很好，但我主要生活在命令行上，真的不想仅仅为了阅读文档而在终端和web浏览器之间切换。这打破了流程，把我带出了禁区。此外，md很容易转换为手册页，或者用于打印或PDF文档的TeX。

(我习惯于使用Ctrl-Z或其他终端选项卡暂停vim，并运行man或perldoc或pydoc等。文本模式浏览器，如lynx或links对我来说不是很好的选择-导航很笨拙，如果我忘记使用200+选项，在我的-width列终端窗口上的输出很难看，而且都不支持javascript)

Answer 1

cargo-readme可能会为您工作。您运行cargo readme -i foo.rs > FOO.md，它将使用来自foo.rs的文档注释的内容填充FOO.md。找到了via reddit。