Markdown and reST

Created on Oct. 27, 2012, 1:53 p.m. by Hevok & updated by Hevok on May 2, 2013, 5:10 p.m.

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.

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

Tags: documentation, rest
Categories: Tutorial
Parent: Markup

Update entry (Admin) | See changes

Comment on This Data Unit