The best practice is to always start using the common denominators of both. In such a conversion from a simple Markdown entry into a full reST data entry can occur instantly.
Common inline markup is::
Mark *italic text* with one arterisk, **bold text** with two. For ``monospaced text``, use two "backquotes" instead.
Mark italic text with one arterisk, bold text with two.
monospaced text, use two "backquotes" instead.
A normal paragraph ending with
:: will flow and be word-wrapped::
If the next paragraph is indented by four or more spaces it will be monospace, without flow (or even wrapping in some non-printing cases.) Multiple paragraphs like this, are possible, as long as they are all intended by the same amount.
If line breaks need to be preserved, but without monospacing them
each line can be started with a vertical bar (
This is only correctly interpreted by Markdown if each line is ended with three whitespaces.
| -- each line is
| where it has to
Compatible syntax for hyperlinks is to surround URLs with angle brackets and found at http://www.denigma.de. Downloads work the same way well https://github.com/hevok/denigma/tarball/master. Even emailing works, can be send at http://www.denigma.de. Downloads work the same way well https://github.com/hevok/denigma/tarball/master. Even emailing works, can be send at email@example.com.