Awesome
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 Raspbian (Raspberry Pi) you need
libncurses5-dev
andlibncursesw5-dev
- on Fedora you need
ncurses-devel
andncurses-c++-libs
Now download and install mdp:
$ git clone https://github.com/visit1985/mdp.git
$ cd mdp
$ make
$ make install
$ mdp sample.md
- On Arch Linux, you can use the existing package.
- on Cygwin you can use the existing package from the setup program.
- On Debian, you can use the existing DEB package, or run
apt-get install mdp
. - On FreeBSD, you can use the port misc/mdp.
- On MacOS, use either the Homebrew Formula by running
brew install mdp
or install with MacPorts withsudo port install mdp
. - On Slackware, grab the SlackBuild here: (http://slackbuilds.org/apps/mdp/), or run
sbopkg -i mdp
. - On Ubuntu, you can use the existing DEB package, or run
apt-get 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 sample.md for more details.
Default controls:
- 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
Configuration:
A config.h
configuration file is available in include/
, change the settings you want and recompile.
Colors, keybindings and list types are configurable as of now. Note that configuring colors only works in 8 color mode.
How to debug it:
To make a debug version of mdp
, just type:
$ make DEBUG=1
Convert to PDF:
- Install
md2pdf
by obtaining the release for your arch and OS or, if you havego
installed, invoke:
$ go install github.com/mandolyte/mdtopdf/cmd/md2pdf@latest
- If you require syntax highlighting, download the gohighlight lexers
md2pdf
supports all major mdp
features and accepts local files, remote HTTP(s) URL and STDIN
inputs.
The below command will convert an mdp
compatible markdown file to a PDF with a dark theme,
syntax highlighting (you'll need to provide the language hint, of course), page/slide separation and a footer:
md2pdf -i https://github.com/jessp01/crash-course-in/raw/main/courses/apt_dpkg_deb/apt_dpkg_deb.md \
-o apt_dpkg_deb.pdf \
-s ~/.config/zaje/syntax_files \
--theme dark \
--new-page-on-hr \
--with-footer \
--author "Jesse Portnoy <jesse@packaman.io>" \
--title "A crash course on handling deb packages"
Since markdown
does not support the centering escape sequences (i.e: ->
and <-
), you will want to remove these before converting, for example:
$ sed 's@^->\s*\(#.*\)\s*<-@\1@g' sample.md | ~/go/bin/md2pdf -o mdp.pdf \
--theme dark --new-page-on-hr