Join 10350+ others. No spamming.
I promise!

Follow us at github.



visit1985 / mdp


A command-line based markdown presentation tool.


mdp - A command-line based markdown presentation tool.


How to get started:

mdp needs the ncursesw headers to compile. So make sure you have them installed:

  • on Ubuntu/Debian you need libncursesw5 and libncursesw5-dev
  • on Cygwin you need libncursesw10 and libncurses-devel

Now download and install mdp:

$ git clone
$ cd mdp
$ make
$ make install
$ mdp

Most terminals support 256 colors only if the TERM variable is set correctly. To enjoy mdp's color fading feature:

$ export TERM=xterm-256color

How to use it:

Horizontal rulers are used as slide separator.

Supports basic markdown formating:

  • line wide markup

    • headlines
    • code
    • quotes
    • unordered list
  • in-line markup

    • bold text
    • underlined text
    • code

Supports headers prefixed by @ symbol.

  • first two header lines are displayed as title and author in top and bottom bar

Review for more details.


  • h, j, k, l, Arrow keys, Space, Enter, Backspace, Page Up, Page Down - next/previous slide
  • Home, g - go to first slide
  • End, G - go to last slide
  • 1-9 - go to slide n
  • r - reload input file
  • q - exit

How to debug it:

To make a debug version of mdp, just type:

$ make DEBUG=1