html - 强调 Doxygen 的 Markdown 中的链接

Question

我似乎无法制作斜体(即*强调*)链接。我尝试了以下语法:

*[text](url)*
[*text*](url)
*[text]*(url)
[*emphasised* text](url)

根据 Doxygen 手册:

a * or _ only starts an emphasis if

• it is followed by an alphanumerical character, and
• it is preceded by a space, newline, or one the following characters <{([,:;

An emphasis ends if

• it is not followed by an alphanumerical character, and
• it is not preceded by a space, newline, or one the following characters ({[<=+-\@

根据这个定义，这应该有效:[*text*](url)，因为 * 后跟一个字母数字字符，前面是一个 [ 字符.它也应该在适当的位置结束，因为 ] 不是字母数字字符，它前面的字母是字母数字。

不幸的是，我的 HTML 输出反而保留了 * 字符，给我留下了一个看起来像这样的链接:*link text*。这是一个错误，还是我没有做对？

Answer 1

作为Babelmark工具演示，除了一个示例之外，所有示例在大多数 Markdown 解析中都运行良好。这似乎是您正在使用的 Markdown 解析器中的错误。您可以考虑将其报告给该项目的开发人员。

请注意，您提供的一个示例不起作用:

*[text]*(url)

那个例子不应该像 rules 那样工作声明以下内容(强调已添加):

To create an inline link, use a set of regular parentheses immediately after the link text’s closing square bracket.

这意味着链接的各个部分之间甚至不允许有空格，尽管某些实现确实允许一个空格。当然不允许使用其他字符。

但是，每个项目都可以包含其他嵌套项目。因此，以下所有内容都是正确的:

*[text](url)*
[*text*](url)
[*emphasised* text](url)

您使用的解析器可能对下划线字符 (_) 有不同的行为。根据rules ，这些字符应该可以互换。然而，正如@user880772 在评论中提到的那样，您可能想尝试使用该字符而不是星号 (*) 来查看是否可以获得所需的输出作为解决方法，直到错误被修复。像这样:

_[text](url)_
[_text_](url)
[_emphasised_ text](url)