added contributors + convert to pdf instructions

[smdp.git] / sample.md

diff --git a/sample.md b/sample.md
index 2a7b934..f7a4d54 100644 (file)
--- a/sample.md
+++ b/sample.md
@@ -1,6 +1,6 @@
 %title: mdp - Sample Presentation
-%author: Michael Göhler
-%date: 2014-09-18
+%author: visit1985
+%date: 2014-09-22
 
 mdp
 ===
@@ -11,6 +11,22 @@ A command-line based markdown presentation tool.
 
 # 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 *===*.
 
@@ -36,6 +52,18 @@ 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
@@ -135,6 +163,22 @@ 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
 
 I hope you like *mdp*. But be aware, that it is
@@ -145,3 +189,4 @@ open an issue on GitHub:
 
 _https://github.com/visit1985/mdp_
 
+