extend sample.md so it looks more like a documentation
[smdp.git] / sample.md
index fa4bad7..2a7b934 100644 (file)
--- a/sample.md
+++ b/sample.md
-@title: Sample Presentation
-@author: Michael Göhler
-@date: 2014-08-07
+%title: mdp - Sample Presentation
+%author: Michael Göhler
+%date: 2014-09-18
 
-Title
-=====
+mdp
+===
 
-This is the first page.
+A command-line based markdown presentation tool.
 
---------------------------------------------------------------------------------
+-------------------------------------------------
 
-# Page 2
+# Supported markdown formatting's
 
-This is another test page.
+First-level headers can be prefixed by single *#*
+or underlined by *===*.
 
-* * *
+\# first-level
 
-## Code example
+becomes
 
-       public static void main() {
+# first-level
+
+-------------------------------------------------
+
+# Supported markdown formatting's
+
+Second-level headers can be prefixed by *##* or
+underlined by *---*.
+
+second-level
+\------------
+
+becomes
+
+second-level
+------------
+
+
+-------------------------------------------------
+
+# Supported markdown formatting's
+
+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!");
     }
 
-Now with different indentation.
+-------------------------------------------------
+
+# Supported markdown formatting's
+
+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's
+
+Inline highlighting is supported as followed:
+
+- *\** colors text as red
+- *\_* underlines text
+
+\_some\_ \*highlighted\* \_\*text\*\_
+
+becomes
+
+_some_ *highlighted* _*text*_
+
+-------------------------------------------------
+
+# Supported markdown formatting's
+
+Backslashes force special markdown characters
+like *\**, *\_*, *#* and *>* to be printed as normal
+characters.
+
+\\\*special\\\*
+
+becomes
+
+\*special\*
+
+-------------------------------------------------
+
+## More information about markdown
+
+can be found on
+
+_http://daringfireball.net/projects/markdown/_
+
+-------------------------------------------------
+
+# Support for UTF-8 special characters
+
+Here are some examples.
+
+ae = ä, oe = ö, ue = ü, ss = ß
+upsilon = Ʊ, phi = ɸ
+
+▛▀▀▀▀▀▀▀▀▀▜
+▌rectangle▐
+▙▄▄▄▄▄▄▄▄▄▟
+
+
+-------------------------------------------------
+
+# Suspend your presentation for hands-on examples
+
+Use *Ctrl + z* to suspend the presentation.
+
+Use *fg* to resume it.
+
+-------------------------------------------------
+
+## Last words
+
+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_
 
-       function expand_tab {
-        }