README.md

   1
   2 ## mdp - A command-line based markdown presentation tool.
   3
   4 ![image](https://cloud.githubusercontent.com/assets/2237222/4280231/d63178fa-3d2a-11e4-88a6-2b8e3608c4ca.gif)
   5
   6 ---
   7
   8 *How to get started:*
   9
  10 mdp needs the ncursesw headers to compile.
  11 So make sure you have them installed:
  12 - On Ubuntu/Debian you need `libncursesw5` and `libncursesw5-dev` to be installed.
  13
  14 Now download and install mdp:
  15
  16     $ git clone https://github.com/visit1985/mdp.git
  17     $ cd mdp
  18     $ make
  19     $ make install
  20     $ mdp sample.md
  21
  22 - On Arch you can use the existing [AUR package](https://aur.archlinux.org/packages/mdp-git/).
  23
  24 ---
  25
  26 *How to use it:*
  27
  28 _Horizontal rulers are used as slide separator._
  29
  30 _Supports basic markdown formating:_
  31
  32 - line wide formating
  33     - headlines
  34     - code
  35     - quotes
  36     - unordered list
  37
  38 - in-line formating
  39     - bold text
  40     - underlined text
  41     - code
  42
  43 _Supports headers prefixed by @ symbol._
  44
  45 - first two header lines are displayed as title and author
  46   in top and bottom bar
  47
  48 _Review sample.md for more details._
  49
  50 ---
  51
  52 *Controls:*
  53
  54 - h, j, k, l, Cursor keys,
  55   Space, Enter, Backspace - next/previous slide
  56 - Home - go to first slide
  57 - End - go to last slide
  58 - 1-9 - go to slide n
  59 - q - exit
  60
  61
  62 ---
  63
  64 *How to debug it:*
  65
  66 To make a debug version of `mdp`, just type:
  67
  68     $ make DEBUG=1