Intellij idea 在IntelliJ中破坏Dart文档注释?

Intellij idea 在IntelliJ中破坏Dart文档注释?,intellij-idea,dart,Intellij Idea,Dart,我在Dart中查看了关于文档的评论,发现了以下内容: ///链接可以是: /// /// * https://www.just-a-bare-url.com ///*[与URL内联](https://google.com) ///*[或分开][参考链接] /// ///[参考链接]:https://google.com /// 但当我在IntelliJ中尝试此功能时,我注意到了两件事: 我无法将链接显示为超链接(当按ctrl+q打开文档时)(通过以任何一个1开头的行。*-+) 我无法使用第一种

我在Dart中查看了关于文档的评论,发现了以下内容:

///链接可以是:
///
/// * https://www.just-a-bare-url.com
///*[与URL内联](https://google.com)
///*[或分开][参考链接]
///
///[参考链接]:https://google.com
///
但当我在IntelliJ中尝试此功能时,我注意到了两件事:

  • 我无法将链接显示为超链接(当按ctrl+q打开文档时)(通过以任何一个
    1开头的行。
    *
    -
    +
  • 我无法使用第一种或第三种形式的链接表达式,即使在列表之外
  • 我正在尝试向使用依赖项的方法添加文档注释,并在注释中链接到依赖项。以下是我的评论:

    /// Doing dot product with a layer of neurons and multiple inputs
    ///
    /// Associated YT NNFS tutorial: [Part-3](*youtube link here*)
    ///
    /// This uses the [ml_linalg][1] dependency. You can also use the [linalg][2] dependency
    ///
    /// [1]: https://pub.dev/packages/ml_linalg
    ///
    /// [2]: https://pub.dev/packages/linalg
    
    下面是IntelliJ如何呈现文档的屏幕截图。youtube链接显示得很好(使用文档中的第二种方法),但会将文档的作者/编辑的文档注释弄乱。但正如你所看到的,第三种形式根本不起作用。方括号中的文本不会转换为链接,第二组方括号中的文本只是连接到第一组方括号中的文本


    如果有人知道我如何将链接添加到我的文档注释中作为列表的一部分,以及如何在链接上添加标记,以及如何在文档注释的末尾添加完整的URL(如第三个示例所示),那将不胜感激。提前非常感谢

    @dev aentgs您是否尝试将我链接到我在问题中已经链接到的同一文档?我甚至明确地复制了我正在努力处理的文档部分。这个文档正是问题的来源。请仔细阅读这个问题,如果你能帮忙,请告诉我。我无意中忽略了文档链接。我不确定问题是否与Dart网站上的文档有关,或者问题是否与IntelliJ有关,或者问题是否与IntelliJ的Dart插件有关,或者问题是否与我版本的Dart SDK或其他东西有关。试试我这里的同一个文档注释,看看你的设置是否遇到同样的问题是的,现在就尝试这听起来像是IntelliJ的问题。该格式是完全正常/标记格式,但只有在编辑器知道并能够理解该格式的情况下,该格式才能在编辑器中工作。我不相信Dart语言服务器正在为注释链接做任何事情。@dev aentgs您刚才是否尝试将我链接到我在问题中已经链接到的同一文档?我甚至明确地复制了我正在努力处理的文档部分。这个文档正是问题的来源。请仔细阅读这个问题,如果你能帮忙,请告诉我。我无意中忽略了文档链接。我不确定问题是否与Dart网站上的文档有关,或者问题是否与IntelliJ有关,或者问题是否与IntelliJ的Dart插件有关,或者问题是否与我版本的Dart SDK或其他东西有关。试试我这里的同一个文档注释,看看你的设置是否遇到同样的问题是的,现在就尝试这听起来像是IntelliJ的问题。该格式是完全正常/标记格式,但只有在编辑器知道并能够理解该格式的情况下,该格式才能在编辑器中工作。我不相信Dart语言服务器会为评论链接做任何事情。