swift - 如何逃避 Swift 文档注释标注？

Question

我在 Swift 中有以下文档注释：

/**
- Trace
- ↓
- Debug
- ↓
- Information
- ↓
- Warning
- ↓
- Error
*/

说“警告”的行不会在 Xcode 中呈现，因为“-警告”是 swift 文档注释中的关键字标注。我怎样才能逃避标注？

Answer 1

​您可以在关键字前使用零宽度空格 ( )：

/**
 - Trace
 - ↓
 - Debug
 - ↓
 - Information
 - ↓
 - ​Warning
 - ↓
 - Error
 */

Answer 2

这不是一个完美的解决方案，但您可以用反引号 (`) 将警告括起来。这会稍微改变它的显示风格：

/**
 - Trace
 - ↓
 - Debug
 - ↓
 - Information
 - ↓
 - `Warning`
 - ↓
 - Error
 */