sample.md

   1 %title: mdp - Sample Presentation
   2 %author: visit1985
   3 %date: 2014-09-22
   4
   5 mdp
   6 ===
   7
   8 A command-line based markdown presentation tool.
   9
  10 -------------------------------------------------
  11
  12 # Supported markdown formatting's
  13
  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
  17 no other characters.
  18
  19 Each of these represents the start of a new slide
  20
  21 \* \* \*
  22 \---
  23 \*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*
  24 \- - -
  25
  26 -------------------------------------------------
  27
  28 # Supported markdown formatting's
  29
  30 First-level headers can be prefixed by single *#*
  31 or underlined by *===*.
  32
  33 \# first-level
  34
  35 becomes
  36
  37 # first-level
  38
  39 -------------------------------------------------
  40
  41 # Supported markdown formatting's
  42
  43 Second-level headers can be prefixed by *##* or
  44 underlined by *---*.
  45
  46 second-level
  47 \------------
  48
  49 becomes
  50
  51 second-level
  52 ------------
  53
  54
  55 -------------------------------------------------
  56
  57 # Supported markdown formatting's
  58
  59 Inline codes are surrounded with backticks.
  60
  61 C program starts with \`main()\`.
  62
  63 becomes
  64
  65 C program starts with `main()`.
  66
  67 -------------------------------------------------
  68
  69 # Supported markdown formatting's
  70
  71 Code blocks are automatically detected by 4
  72 spaces at the beginning of a line.
  73
  74 Tabs are automatically expanded to 4 spaces
  75 while parsing the input.
  76
  77 \    int main(int argc, char \*argv[]) {
  78 \        printf("%s\\n", "Hello world!");
  79 \    }
  80
  81 becomes
  82
  83     int main(int argc, char *argv[]) {
  84         printf("%s\n", "Hello world!");
  85     }
  86
  87 -------------------------------------------------
  88
  89 # Supported markdown formatting's
  90
  91 Quotes are auto-detected by preceding *>*.
  92
  93 Multiple *>* are interpreted as nested quotes.
  94
  95 \> quote
  96 \>> nested quote 1
  97 \> > nested quote 2
  98
  99 becomes
 100
 101 > quote
 102 >> nested quote 1
 103 > > nested quote 2
 104
 105 -------------------------------------------------
 106
 107 # Supported markdown formatting's
 108
 109 Inline highlighting is supported as followed:
 110
 111 \- *\** colors text as red
 112 \- *\_* underlines text
 113
 114 \_some\_ \*highlighted\* \_\*text\*\_
 115
 116 becomes
 117
 118 _some_ *highlighted* _*text*_
 119
 120 -------------------------------------------------
 121
 122 # Supported markdown formatting's
 123
 124 Backslashes force special markdown characters
 125 like *\**, *\_*, *#* and *>* to be printed as normal
 126 characters.
 127
 128 \\\*special\\\*
 129
 130 becomes
 131
 132 \*special\*
 133
 134 -------------------------------------------------
 135
 136 # Supported markdown formatting's
 137
 138 The leading stars or minuses make list.
 139
 140 TODO list:
 141 \* TODO major 1
 142 \    \- TODO minor 1.1
 143 \    \- TODO minor 1.2
 144 \* TODO major 2
 145 \* TODO major 3
 146 \    \* TODO minor 3.1
 147 \    \* TODO minor 3.2
 148
 149 becomes
 150
 151 TODO list:
 152 * TODO major 1
 153     - TODO minor 1.1
 154     - TODO minor 1.2
 155 * TODO major 2
 156 * TODO major 3
 157     * TODO minor 3.1
 158     * TODO minor 3.2
 159
 160 -------------------------------------------------
 161
 162 ## More information about markdown
 163
 164 can be found on
 165
 166 _http://daringfireball.net/projects/markdown/_
 167
 168 -------------------------------------------------
 169
 170 # Support for UTF-8 special characters
 171
 172 Here are some examples.
 173
 174 ae = ä, oe = ö, ue = ü, ss = ß
 175 upsilon = Ʊ, phi = ɸ
 176
 177 ▛▀▀▀▀▀▀▀▀▀▜
 178 ▌rectangle▐
 179 ▙▄▄▄▄▄▄▄▄▄▟
 180
 181
 182 -------------------------------------------------
 183
 184 # Suspend your presentation for hands-on examples
 185
 186 Use *Ctrl + z* to suspend the presentation.
 187
 188 Use *fg* to resume it.
 189
 190 -------------------------------------------------
 191
 192 # Convert your presentation to PDF
 193
 194 To publish your presentation later on, you may
 195 want to convert it to PDF.
 196
 197 This can be achieved by two additional tools:
 198
 199 \- *markdown* to convert to HTML
 200 \- *wkhtmltopdf* to convert from HTML to PDF
 201
 202 After installing them, you can simply type:
 203
 204     $ markdown sample.md | wkhtmltopdf - sample.pdf
 205
 206 -------------------------------------------------
 207
 208 ## Last words
 209
 210 I hope you like *mdp*. But be aware, that it is
 211 still in alpha status.
 212
 213 If you observe strange behavior, feel free to
 214 open an issue on GitHub:
 215
 216 _https://github.com/visit1985/mdp_
 217
 218