title: How do I create an arbitrary link in YARD documentation?
body: <p>I'm trying to create some links in my YARD documentation.  I can get an HTTP link:</p>
  
  <pre><code># I like {http://stackoverflow.com Stackoverflow}
  </code></pre>
  
  <p>renders as</p>
  
  <pre><code>&lt;p&gt;I like &lt;a href="http://stackoverflow.com"&gt;Stackoverflow&lt;/a&gt;&lt;/p&gt;
  </code></pre>
  
  <p>But an email link:</p>
  
  <pre><code># You can email the {mailto:bugs@myproject.com bugs} list
  </code></pre>
  
  <p>gives me a warning:</p>
  
  <pre><code>[warn]: In file `':: Cannot resolve link to mailto:bugs@myprojectmailto:bugs@myproject.com from text:
  </code></pre>
  
  <p>and  renders as</p>
  
  <pre><code>&lt;p&gt;You can email the &lt;tt&gt;bugs&lt;/tt&gt; list&lt;/p&gt;
  </code></pre>
  
  <p>I've tried the regular RDoc syntax for links:</p>
  
  <pre><code>bugs[mailto:bugs@myproject.com]
  </code></pre>
  
  <p>but YARD seems to ignore that.  Does anyone know of a more reliable syntax?</p>