Greetings AsciiDocumenters, 
  One feature of the Markdown syntax that greatly help the readability
of the source document is the hyperlink with named target.  I'm not
sure if it's possible to do those with AsciiDoc; let met explain what
it's all about.

URLs tend to be very long and includes plenty of ugly cryptic
characters.  With Markdown, it's possible to put an URL right next to
its label, just like with AsciiDoc but the other way around.  It is
also possible to make the label reference a named or numbers link that
is given later on, typically after the paragraph or at the end of the
section.  That way, the paragraph is mostly flowing prose and long
URLs appear alone on a single line.  Here is an example:

  There are many light weight markup languages out there.  One of then
  it [Markdown][1].  It is popular in web application where is enables
  users to do basic formating without giving them the full power of
  HTML, which could lead to security problems.  An alternative is
  [AsciiDoc][2], a markup just as readable but with a lot more bangs
  and whistles; AsciiDoc offers the full semantic power of DocBook
  without the ugliness of XML.

  [1]: http://daringfireball.net/projects/markdown/
  [2]: http://www.methods.co.nz/asciidoc/

As you can see, the named links prevent awkward line breaks in the
prose block.  Is there a way to do the same with AsciiDoc?

-- 
Yannick Gingras
_______________________________________________
asciidoc-discuss mailing list
[email protected]
http://lists.metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss

Reply via email to