logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

mdp - A command-line based markdown presentation tool

Author

       Written by Michael Goehler and others, see https://github.com/visit1985/mdp/blob/master/AUTHORS.

Color Support

       Most  terminals  are  able  to  display  256 colors these days. But some of them enable only 16 colors by
       default. To enjoy mdp's full capabilities, these terminals need to be signaled to enable 256 color  mode.
       This is usually done by setting the TERM environment variable.

       exportTERM=xterm-256color

Description

mdp  is  a  command-line  program  that  allows you to make elegant presentations from markdownformattedFILEs.

       It is as easy as write your presentation content in the text editor of your  preference  and  launch  the
       presentation from the command-line.

Environment Variables

OutputControlMDP_LIST_HEAD[1-3],MDP_LIST_OPEN[1-3]
              Controls the list characters of unordered lists.

              The default is equivalent to:
              MDP_LIST_OPEN1=' |  '
              MDP_LIST_OPEN2=' |  '
              MDP_LIST_OPEN3=' |  '
              MDP_LIST_HEAD1=' +- '
              MDP_LIST_HEAD2=' +- '
              MDP_LIST_HEAD3=' +- '

Keyboard Controls

h,j,k,l,Arrowkeys,Space,Enter,Backspace,PageUp,PageDown
              Display next/previous slide or continue after a stop point.

       g,Home
              Jump to first slide.

       G,End Jump to last slide.

       1..N   Jump to Nth slide.

       r      Reload the input FILE. This key is disabled if input was read from standard input.

       q      Exit mdp.

Markdown Formatting

       For a complete list of supported markups, refer the sample presentation  (sample.md)  provided  alongside
       mdp, or online available at https://github.com/visit1985/mdp.

   Slides
       The  input  FILE  is split into multiple slides by horizontal rules. Each consisting of at least 3 --- or
       *** characters on a single line.  Thislinemustbeprefixedbyancompletelyemptyline.   It  can  also
       contain spaces but no other characters.

       If  any  slide  is  too  large to fit into your current screen, an error message will be displayed at the
       moment the presentation is launched.

   Line-by-LineModeBlock-by-BlockMode
       A single <br>, <BR> or ^ on an otherwise empty line signals mdp to stop output of the current slide (stop
       point) and wait for a key-press by the user.

       This enables the user to display bullet points or list items one by one (line by line) or block by block.

   Headersmdp supports header lines in the format  of  @[DESCRIPTION]  [VALUE]  The  first  two  header  lines  are
       displayed as title and author in top and bottom bar.

       Headers are only recognized at the top of the input FILE.

   Linespanningmarkup
       Supported are headlines, code blocks, quotes and unordered lists.

   In-linemarkup
       As well as bold text, underlined text and in-line code.

Name

       mdp - A command-line based markdown presentation tool

Options

InputControlFILE   The  input  file from which the presentation is read. If no file is specified, or if the file name
              is -, the presentation is read from standard input.

   OutputControl-e, --expand
              Enable character entity expansion (e.g. '&gt;' becomes '>').

       -f, --nofade
              Disable color fading in 256 color mode.

       -i, --invert
              Swap black and white color.

       -t, --notrans
              Disable transparency in transparent terminal.

   MiscellaneousOptions-d, --debug
              Enable debug messages on STDERR. Add multiple times to increases debug level.

       -h, --help
              Display usage message and exit.

       -v, --version
              Display version and license information.

Synopsis

mdp [OPTION]... [FILE]

See Also