+The input file is split into multiple slides by
+horizontal rules (hr). A hr consisting of at
+least 3 *\** or *-*. It can also contain spaces but
+no other characters.
+
+Each of these represents the start of a new slide.
+
+\* \* \*
+\---
+\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*
+\- - -
+
+-------------------------------------------------
+
+-> # Supported markdown formatting <-
+
+First-level headers can be prefixed by single *#*
+or underlined by *===*.
+
+\# first-level
+
+becomes
+
+# first-level
+
+-------------------------------------------------
+
+-> # Supported markdown formatting <-
+
+Second-level headers can be prefixed by *##* or
+underlined by *---*.
+
+second-level
+\------------
+
+becomes
+
+second-level
+------------
+
+
+-------------------------------------------------
+
+-> # Supported markdown formatting's <-
+
+Inline codes are surrounded with backticks.
+
+C program starts with \`main()\`.
+
+becomes
+
+C program starts with `main()`.
+
+-------------------------------------------------
+
+-> # Supported markdown formatting <-
+
+Code blocks are automatically detected by 4 spaces
+at the beginning of a line.
+
+Tabs are automatically expanded to 4 spaces while
+parsing the input.
+
+\ int main(int argc, char \*argv[]) {
+\ printf("%s\\n", "Hello world!");
+\ }
+
+becomes
+
+ int main(int argc, char *argv[]) {
+ printf("%s\n", "Hello world!");
+ }
+
+-------------------------------------------------
+
+-> # Supported markdown formatting <-
+
+You can also use [pandoc](http://pandoc.org/demo/example9/pandocs-markdown.html)'s fenced code block
+extension. Use at least three ~ chars to open and
+at least as many or more ~ for closing.
+
+\~~~ {.numberLines}
+\int main(int argc, char \*argv[]) {
+\ printf("%s\\n", "Hello world!");
+\}
+\~~~~~~~~~~~~~~~~~~
+
+becomes
+
+~~~ {.numberLines}
+int main(int argc, char \*argv[]) {
+ printf("%s\\n", "Hello world!");
+}
+~~~~~~~~~~~~~~~~~~
+
+Pandoc attributes (like ".numberlines" etc.)
+will be ignored
+
+-------------------------------------------------
+
+-> # Supported markdown formatting <-
+
+Quotes are auto-detected by preceding *>*.
+
+Multiple *>* are interpreted as nested quotes.
+
+\> quote
+\>> nested quote 1
+\> > nested quote 2
+
+becomes
+
+> quote
+>> nested quote 1
+> > nested quote 2
+
+-------------------------------------------------
+
+-> # Supported markdown formatting <-
+
+Inline highlighting is supported as followed:
+
+\- *\** colors text as red
+\- *\_* underlines text
+
+\_some\_ \*highlighted\* \_\*text\*\_
+
+becomes
+
+_some_ *highlighted* _*text*_
+
+-------------------------------------------------
+
+-> # Supported markdown formatting <-
+
+Backslashes force special markdown characters
+like *\**, *\_*, *#* and *>* to be printed as
+normal characters.
+
+\\\*special\\\*
+
+becomes
+
+\*special\*
+
+-------------------------------------------------
+
+-> # Supported markdown formatting <-
+
+Leading *\** or *-* indicate lists.
+
+list
+\* major
+\ - minor
+\ - \*important\*
+\ detail
+\ - minor
+
+becomes
+
+list
+* major
+ - minor
+ - *important*
+ detail
+ - minor
+
+-------------------------------------------------
+
+-> # Supported markdown formatting <-
+
+A single *\<br\>* or *^* in a line indicates mdp
+to stop the output on that position.
+
+This can be used to show bullet points
+line by line.
+
+*\<br\>* is also not displayed in HTML converted
+output.
+
+Agenda
+<br>
+* major
+<br>
+ * minor
+<br>
+* major
+ ^
+ * minor
+ ^
+ * detail
+
+-------------------------------------------------
+
+-> # Supported markdown formatting <-
+
+Leading *->* indicates centering.
+
+\-> # test <-
+\-> ## test <-
+\-> test
+\-> \_\*test\*\_ <-
+
+becomes
+
+-> # test <-
+-> ## test <-
+-> test
+-> _*test*_ <-
+
+-------------------------------------------------
+
+-> # Supported markdown formatting <-
+
+URL in pandoc style are supported:
+
+\[Google](http://www.google.com/)
+
+becomes
+
+[Google](http://www.google.com/)
+
+-------------------------------------------------
+
+-> ## More information about markdown <-
+
+can be found in the [markdown documentation](http://daringfireball.net/projects/markdown/).
+
+-------------------------------------------------
+
+-> # Support for UTF-8 special characters <-
+
+Here are some examples.