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 ## More information about markdown
 137
 138 can be found on
 139
 140 _http://daringfireball.net/projects/markdown/_
 141
 142 -------------------------------------------------
 143
 144 # Support for UTF-8 special characters
 145
 146 Here are some examples.
 147
 148 ae = ä, oe = ö, ue = ü, ss = ß
 149 upsilon = Ʊ, phi = ɸ
 150
 151 ▛▀▀▀▀▀▀▀▀▀▜
 152 ▌rectangle▐
 153 ▙▄▄▄▄▄▄▄▄▄▟
 154
 155
 156 -------------------------------------------------
 157
 158 # Suspend your presentation for hands-on examples
 159
 160 Use *Ctrl + z* to suspend the presentation.
 161
 162 Use *fg* to resume it.
 163
 164 -------------------------------------------------
 165
 166 # Convert your presentation to PDF
 167
 168 To publish your presentation later on, you may
 169 want to convert it to PDF.
 170
 171 This can be achieved by two additional tools:
 172
 173 - *markdown* to convert to HTML
 174 - *wkhtmltopdf* to convert from HTML to PDF
 175
 176 After installing them, you can simply type:
 177
 178     $ markdown sample.md | wkhtmltopdf - sample.pdf
 179
 180 -------------------------------------------------
 181
 182 ## Last words
 183
 184 I hope you like *mdp*. But be aware, that it is
 185 still in alpha status.
 186
 187 If you observe strange behavior, feel free to
 188 open an issue on GitHub:
 189
 190 _https://github.com/visit1985/mdp_
 191
 192