强调Doxygen Markdown中的链接

时间:2015-07-22 19:17:14

标签: html markdown doxygen

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

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

根据Doxygen手册:

  

a *或_只在

时开始强调      
      
  • 后面跟着一个字母数字字符,
  •   
  • 前面有空格,换行符或以下字符之一< {([,:;
  •   
     

如果

,重点就会结束      
      
  • 后面没有字母数字字符,
  •   
  • 前面没有空格,换行符或以下字符之一({[< = + - \ @
  •   

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

不幸的是,我的HTML输出保留了*字符,留下了一个如下所示的链接:* link text *。这是一个错误,还是我做得不对?

1 个答案:

答案 0 :(得分:2)

正如Babelmark工具所示,除了一个示例外,其他所有示例都适用于大多数Markdown分析。这似乎是您正在使用的Markdown解析器中的错误。您可以考虑将其报告给该项目的开发人员。

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

*[text]*(url)

该示例永远不会像rules状态那样起作用(强调添加):

  

要创建内联链接,请在链接文本的结束方括号后使用一组常规括号立即

这意味着即使某些实现允许单个空间,也不应该在链接的各个部分之间允许空格。当然不应该允许其他角色。

但是,每个项目都可以包含其他嵌套项目。出于这个原因,以下所有内容都是正确的:

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

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

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