如何逃避Swift doc评论Callout？

Question

我在Swift中有以下文档评论：

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

表示＆＃34;警告＆＃34;不会在Xcode中呈现，因为＆＃34; - 警告＆＃34;是swift doc评论中的关键字标注。我怎样才能逃脱标注？

Answer 1

不是一个完美的解决方案，但你可以用反引号（`）包围警告。这会稍微改变它的显示风格：

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

Answer 2

您可以在关键字前使用零宽度的空格（​）

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