X-Git-Url: https://git.danieliu.xyz/?a=blobdiff_plain;f=sample.md;h=95d767e7727812d59c05f6699e7e1be052681150;hb=6d627bac82f84e39beda51981ddf3a6ddabbbe78;hp=2a7b9347f0536b4338a9fe2b8eb49b2768b97a1e;hpb=785ae9e96355a7d14e9ab37e4ef9662e5f19d8e0;p=smdp.git

diff --git a/sample.md b/sample.md
index 2a7b934..95d767e 100644
--- a/sample.md
+++ b/sample.md
@@ -1,15 +1,45 @@
 %title: mdp - Sample Presentation
-%author: Michael Göhler
-%date: 2014-09-18
+%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'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.
+
+Each of these represents the start of a new slide
+
+\* \* \*
+\---
+\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*
+\- - -
+
+-------------------------------------------------
+
+-> # Supported markdown formatting's <-
 
 First-level headers can be prefixed by single *#*
 or underlined by *===*.
@@ -22,7 +52,7 @@ becomes
 
 -------------------------------------------------
 
-# Supported markdown formatting's
+-> # Supported markdown formatting's <-
 
 Second-level headers can be prefixed by *##* or
 underlined by *---*.
@@ -38,7 +68,19 @@ second-level
 
 -------------------------------------------------
 
-# Supported markdown formatting's
+-> # 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.
@@ -58,7 +100,7 @@ becomes
 
 -------------------------------------------------
 
-# Supported markdown formatting's
+-> # Supported markdown formatting's <-
 
 Quotes are auto-detected by preceding *>*.
 
@@ -76,12 +118,12 @@ becomes
 
 -------------------------------------------------
 
-# Supported markdown formatting's
+-> # Supported markdown formatting's <-
 
 Inline highlighting is supported as followed:
 
-- *\** colors text as red
-- *\_* underlines text
+\- *\** colors text as red
+\- *\_* underlines text
 
 \_some\_ \*highlighted\* \_\*text\*\_
 
@@ -91,7 +133,7 @@ _some_ *highlighted* _*text*_
 
 -------------------------------------------------
 
-# Supported markdown formatting's
+-> # Supported markdown formatting's <-
 
 Backslashes force special markdown characters
 like *\**, *\_*, *#* and *>* to be printed as normal
@@ -105,15 +147,65 @@ becomes
 
 -------------------------------------------------
 
-## More information about markdown
+-> # Supported markdown formatting's <-
+
+Leading *\** or *-* indicate lists.
 
-can be found on
+list
+\* major
+\    - minor
+\        - \*important\*
+\          detail
+\    - minor
 
-_http://daringfireball.net/projects/markdown/_
+becomes
+
+list
+* major
+    - minor
+        - *important*
+          detail
+    - minor
 
 -------------------------------------------------
 
-# Support for UTF-8 special characters
+-> # Supported markdown formatting's <-
+
+Leading *->* indicates centering.
+
+\-> # test <-
+\-> ## test <-
+\-> test
+\-> \_\*test\*\_ <-
+
+becomes
+
+-> # test <-
+-> ## test <-
+-> test
+-> _*test*_ <-
+
+-------------------------------------------------
+
+-> # Supported markdown formatting's <-
+
+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.
 
@@ -127,7 +219,7 @@ upsilon = Ʊ, phi = ɸ
 
 -------------------------------------------------
 
-# Suspend your presentation for hands-on examples
+-> # Suspend your presentation for hands-on examples <-
 
 Use *Ctrl + z* to suspend the presentation.
 
@@ -135,13 +227,28 @@ Use *fg* to resume it.
 
 -------------------------------------------------
 
-## Last words
+-> # 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 <-
 
 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:
+open an issue on [GitHub](https://github.com/visit1985/mdp).
 
-_https://github.com/visit1985/mdp_