Dart文档注释中如何转义方括号以正确展示半开区间？

Dart 文档注释的解析器会把未转义的单[识别为代码标识符链接的起始标记，你写的[[start],[end])里连续两个[会让解析器无法正确匹配链接的开闭规则，最终出现渲染错乱。

分两种常见使用场景选择：

不需要参数跳转能力 #

如果不需要点击start/end直接跳转到对应参数定义，直接把区间文本包裹进行内代码即可，完全不会触发链接解析逻辑：

/// Gets all items within period `[start, end)`.

这种写法渲染后会直接显示正常的半开区间符号，无格式异常。

需要保留参数跳转能力 #

如果希望start/end仍然被IDE识别为代码参数、支持点击跳转，只需要把作为区间左括号的字面[用反斜杠\转义即可：

/// Gets all items within period \[`[start]`, `[end]`).

注意：不要转义[start]、[end]前后用来触发链接的方括号，否则会失去跳转能力，还会显示多余的反斜杠。你之前用反斜杠没生效，大概率是转义位置不对，把链接相关的方括号也转义了。

内容的提问来源于stack exchange，提问作者Stuck