Replace directive
=================

.. |reST| replace:: reStructuredText

Yes, |reST|__ is a long word, so I can't blame anyone for wanting to
abbreviate it.

__ http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html

As reStructuredText doesn't support nested inline markup, the only way to
create a reference with styled text is to use substitutions with the "replace"
directive:

I recommend you try |Python|_.

.. |Python| replace:: Python, *the* best language around
.. _Python: http://www.python.org/

