created on Oct. 27, 2012, 1:53 p.m. by Hevok & updated on Oct. 31, 2012, 1:28 a.m. by Hevok
Denigma supports multiple markup languages, notable both Markdown and reStructuredText (reST), which have inherently some incompatibilies.
Pandoc can be used to convert Markdown into reST, e.g. with and online convert at http://johnmacfarlane.net/pandoc.try. However such a procedure is not necessary.
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.
For 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.
| nice
| great
| -- each line
is
| where it has to
| be
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 hyper@link.de.
At Denigma alternatively URLs can be surrounded by square brackets [].
The use of URLs directly has the advantage that a human reader can always copy and paste the URL.
Comment on This Data Unit