Swift 类文档未显示在Xcode中

我正在写一个UIKit库，它需要很多文档

我已经在每个库中添加了常规文档，但它没有显示在快速帮助中

例如：

import UIKit

/// An extension of Apples [`UILabel`](https://developer.apple.com/documentation/uikit/uilabel).
///
/// The whole label is configurable within the storyboard builder using the`@IBInspectable`.
///
///     let myLabel = MyLabel()
///
@IBDesignable
open class MyLabel: UILabel {
}

我在这里得到的只是：

如果将文档重新排序为：

/// An extension of Apples [`UILabel`](https://developer.apple.com/documentation/uikit/uilabel).
///
/// The whole label is configurable within the storyboard builder using the`@IBInspectable`.
///
///     let myLabel = MyLabel()
///

import UIKit

@IBDesignable
open class MyLabel: UILabel {
}

或

导入UIKit

@IBDesignable
/// An extension of Apples [`UILabel`](https://developer.apple.com/documentation/uikit/uilabel).
///
/// The whole label is configurable within the storyboard builder using the`@IBInspectable`.
///
///     let myLabel = MyLabel()
///
open class MyLabel: UILabel {
}

我至少看到了：

但我的书面文件什么都没有。方法或字段文档似乎工作正常

如何正确编写类文档？这有什么关系吗？@IBDesignables其他类似乎工作正常

我已经在Xcode 9.x.x和Xcode 10.0测试版中试用过

---

Jazzy可以正确地导出所有内容。

删除评论第一行中的严肃口音。Xcode在链接中似乎不支持这一点！如果删除它们，将提供快速帮助

而不是

/// An extension of Apples [`UILabel`](https://...)

使用

---

你就是那个人！只有当`在链接中时，它才会渲染。请用一个例子来编辑你的答案，这个例子是有效的，而不是无效的，这样就更清楚了。非常感谢你！喜欢那样吗？

/// An extension of Apples [UILabel](https://...)