See how I do it:
.. _`docutils`: http://docutils.sourceforge.net/ `docutils`_ is best extensible plain text markup in the world!
For a reference to a place:
`Installation instructions <INSTALL.html>`_
For footnotes:
See [RFC822]_ for mail format. .. [RFC822] http:
UPDATE For whose top-down direct answer to the question (this shows that Markdown is less capable than REST):
.. _RFC822: http://www.ietf.org/rfc/rfc0822.txt .. _alias: RFC822_ Please read `RFC822`_. Please read `alias`_. Please read `RFC 822 <RFC822_>`_. Please read `RFC 822 <alias_>`_.
Enjoy it!
source share