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&gt]. However such a procedure is not necessary. ¶
¶
The best practices 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. ¶
¶
Emphasis & Examples ¶
------------------- ¶
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. ¶
¶
Code/Console Blocks ¶
------------------- ¶
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. ¶
¶
Line Blocks ¶
----------- ¶
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 ¶
¶
Hyperlinks ¶
---------- ¶
Compatible syntax for hyperlinks is to surround URLs with angle brackets and found at <http://www.denigma.de&gt]. Downloads work the same way well <https://github.com/hevok/denigma/tarball/master&gt'>https://github.com/hevok/denigma/tarball/master&gt]. 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.