cleanup and small change of list spacing in #38 + shortened sample
[smdp.git] / sample.md
index e35b9e8..57abf3d 100644 (file)
--- a/sample.md
+++ b/sample.md
-%title: Sample Presentation
-%author: Michael Göhler
-%date: 2014-08-07
+%title: mdp - Sample Presentation
+%author: visit1985
+%date: 2014-09-22
 
-Title
-=====
+mdp
+===
 
-This is the first page.
+A command-line based markdown presentation tool.
 
-------------------------------------
+-------------------------------------------------
 
-These are 3 stars: \*\*\*
-And two backslashes: \\\\
+# Supported markdown formatting's
 
----
+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.
 
-# Page 2
+Each of these represents the start of a new slide
 
-This is another test page.
+\* \* \*
+\---
+\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*
+\- - -
 
-* * *
+-------------------------------------------------
 
-## Code example
+# Supported markdown formatting's
 
-       public static void main() {
+First-level headers can be prefixed by single *#*
+or underlined by *===*.
+
+\# first-level
+
+becomes
+
+# 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
+
+Inline codes are surrounded with backticks.
+
+C program starts with \`main()\`.
+
+becomes
+
+C program starts with `main()`.
+
+-------------------------------------------------
+
+# 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\*
+
+-------------------------------------------------
+
+# Supported markdown formatting's
+
+Leading *\** or *-* indicate lists.
+
+TODO list
+\* major 1
+\    \- minor 1.1
+\        \- detail 1.1.1
+\        \- detail 1.1.2
+\    \- minor 1.2
+
+becomes
+
+TODO list
+* major 1
+    - minor 1.1
+        - detail 1.1.1
+        - detail 1.1.2
+    - minor 1.2
+
+-------------------------------------------------
+
+## 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.
+
+-------------------------------------------------
+
+# Convert your presentation to PDF
+
+To publish your presentation later on, you may
+want to convert it to PDF.
+
+This can be achieved by two additional tools:
+
+\- *markdown* to convert to HTML
+\- *wkhtmltopdf* to convert from HTML to PDF
+
+After installing them, you can simply type:
+
+    $ markdown sample.md | wkhtmltopdf - sample.pdf
+
+-------------------------------------------------
+
+## Last words
 
-       function expand_tab {
-        }
+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:
 
-Another Title
--------------
+_https://github.com/visit1985/mdp_
 
-And some Text.