%author: visit1985
%date: 2014-09-22
-mdp
-===
+-> mdp <-
+=========
-A command-line based markdown presentation tool.
+-> A command-line based markdown presentation tool. <-
+
+_Basic controls:_
+
+next slide *Enter*, *Space*, *Page Down*, *j*, *l*,
+ *Down Arrow*, *Right Arrow*
+
+previous slide *Backspace*, *Page Up*, *h*, *k*,
+ *Up Arrow*, *Left Arrow*
+
+quit *q*
+reload *r*
+slide N *1..9*
+first slide *Home*, *g*
+last slide *End*, *G*
-------------------------------------------------
-# Supported markdown formatting's
+-> # Supported markdown formatting <-
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
+Each of these represents the start of a new slide.
\* \* \*
\---
-------------------------------------------------
-# Supported markdown formatting's
+-> # Supported markdown formatting <-
First-level headers can be prefixed by single *#*
or underlined by *===*.
-------------------------------------------------
-# Supported markdown formatting's
+-> # Supported markdown formatting <-
Second-level headers can be prefixed by *##* or
underlined by *---*.
-------------------------------------------------
-# Supported markdown formatting's
+-> # Supported markdown formatting's <-
Inline codes are surrounded with backticks.
-------------------------------------------------
-# Supported markdown formatting's
+-> # Supported markdown formatting <-
Code blocks are automatically detected by 4
spaces at the beginning of a line.
-------------------------------------------------
-# Supported markdown formatting's
+-> # Supported markdown formatting <-
Quotes are auto-detected by preceding *>*.
-------------------------------------------------
-# Supported markdown formatting's
+-> # Supported markdown formatting <-
Inline highlighting is supported as followed:
-------------------------------------------------
-# Supported markdown formatting's
+-> # Supported markdown formatting <-
Backslashes force special markdown characters
like *\**, *\_*, *#* and *>* to be printed as normal
-------------------------------------------------
-# Supported markdown formatting's
+-> # Supported markdown formatting <-
Leading *\** or *-* indicate lists.
-TODO list
-\* major 1
-\ \- minor 1.1
-\ \- detail 1.1.1 \*IMPORTANT\*
-\ \- detail 1.1.2
-\ \- minor 1.2
+list
+\* major
+\ - minor
+\ - \*important\*
+\ detail
+\ - minor
becomes
-TODO list
-* major 1
- - minor 1.1
- - detail 1.1.1 *IMPORTANT*
- - detail 1.1.2
- - minor 1.2
+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's
+-> # Supported markdown formatting <-
Leading *->* indicates centering.
-------------------------------------------------
-## More information about markdown
+-> # Supported markdown formatting <-
-can be found on
+URL in pandoc style are supported:
-_http://daringfireball.net/projects/markdown/_
+\[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
+-> # Support for UTF-8 special characters <-
Here are some examples.
-------------------------------------------------
-# Suspend your presentation for hands-on examples
+-> # Suspend your presentation for hands-on examples <-
Use *Ctrl + z* to suspend the presentation.
-------------------------------------------------
-# Convert your presentation to PDF
+-> # Convert your presentation to PDF <-
To publish your presentation later on, you may
want to convert it to PDF.
-------------------------------------------------
-## Last words
+-> ## Last words <-
-I hope you like *mdp*. But be aware, that it is
+I hope you like *mdp*. But be aware that it is
still in alpha status.
If you observe strange behavior, feel free to
-open an issue on GitHub:
-
-_https://github.com/visit1985/mdp_
-
-
+open an issue on [GitHub](https://github.com/visit1985/mdp).