1 %title: mdp - Sample Presentation
8 A command-line based markdown presentation tool.
10 -------------------------------------------------
12 # Supported markdown formatting's
14 The input file is split into multiple slides by
15 horizontal rules (hr). A hr consisting of at
16 least 3 *\** or *-*. It can also contain spaces but
19 Each of these represents the start of a new slide
23 \*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*
26 -------------------------------------------------
28 # Supported markdown formatting's
30 First-level headers can be prefixed by single *#*
31 or underlined by *===*.
39 -------------------------------------------------
41 # Supported markdown formatting's
43 Second-level headers can be prefixed by *##* or
55 -------------------------------------------------
57 # Supported markdown formatting's
59 Inline codes are surrounded with backticks.
61 C program starts with \`main()\`.
65 C program starts with `main()`.
67 -------------------------------------------------
69 # Supported markdown formatting's
71 Code blocks are automatically detected by 4
72 spaces at the beginning of a line.
74 Tabs are automatically expanded to 4 spaces
75 while parsing the input.
77 \ int main(int argc, char \*argv[]) {
78 \ printf("%s\\n", "Hello world!");
83 int main(int argc, char *argv[]) {
84 printf("%s\n", "Hello world!");
87 -------------------------------------------------
89 # Supported markdown formatting's
91 Quotes are auto-detected by preceding *>*.
93 Multiple *>* are interpreted as nested quotes.
105 -------------------------------------------------
107 # Supported markdown formatting's
109 Inline highlighting is supported as followed:
111 \- *\** colors text as red
112 \- *\_* underlines text
114 \_some\_ \*highlighted\* \_\*text\*\_
118 _some_ *highlighted* _*text*_
120 -------------------------------------------------
122 # Supported markdown formatting's
124 Backslashes force special markdown characters
125 like *\**, *\_*, *#* and *>* to be printed as normal
134 -------------------------------------------------
136 # Supported markdown formatting's
138 The leading stars or minuses make list.
164 -------------------------------------------------
166 ## More information about markdown
170 _http://daringfireball.net/projects/markdown/_
172 -------------------------------------------------
174 # Support for UTF-8 special characters
176 Here are some examples.
178 ae = ä, oe = ö, ue = ü, ss = ß
186 -------------------------------------------------
188 # Suspend your presentation for hands-on examples
190 Use *Ctrl + z* to suspend the presentation.
192 Use *fg* to resume it.
194 -------------------------------------------------
196 # Convert your presentation to PDF
198 To publish your presentation later on, you may
199 want to convert it to PDF.
201 This can be achieved by two additional tools:
203 \- *markdown* to convert to HTML
204 \- *wkhtmltopdf* to convert from HTML to PDF
206 After installing them, you can simply type:
208 $ markdown sample.md | wkhtmltopdf - sample.pdf
210 -------------------------------------------------
214 I hope you like *mdp*. But be aware, that it is
215 still in alpha status.
217 If you observe strange behavior, feel free to
218 open an issue on GitHub:
220 _https://github.com/visit1985/mdp_