如何让“annotate_models”gem 在降价中与 yard 一起使用？答案

【问题标题】：How do I get `annotate_models` gem to work with yard in markdown?如何让“annotate_models”gem 在降价中与 yard 一起使用？
【发布时间】：2016-08-31 19:10:42
【问题描述】：

我如何让annotate_models gem 在 markdown 中与 yard 一起使用？

目前，我在.yardopts 中指定--markup markdown 并在auto_annotate_models.rake 中使用以下内容：

'format_markdown'         => 'true'

然而，markdown 渲染得非常奇怪。文件如下所示：

【问题讨论】：

标签： ruby-on-rails ruby documentation-generation annotate yard

【解决方案1】：

Annotate 生成与kramdown 兼容的降价，因此在.yardopts 中指定--markup markdown --markup-provider kramdown 可以解决此问题。

这是固定的渲染：

【讨论】：