mdp is a command-line based markdown presentation tool.
mdp solves the problem of presenting slides without leaving the terminal or converting markdown to another format. It reads markdown files where horizontal rulers separate slides, parses basic markdown syntax including headlines, code blocks, quotes, lists, bold and underlined text, and renders them in the terminal using ncurses. Navigation happens through keyboard controls for moving between slides, jumping to specific slides, reloading the file, and exiting.
The tool suits developers and technical presenters who work primarily in the terminal and want to write presentations in plain markdown. It works across multiple operating systems through both direct compilation and distribution packages. The project offers configuration through a header file where colors, keybindings, and list types can be customized before recompilation, and supports 256-color terminals when the TERM variable is set appropriately. Headers prefixed with the @ symbol receive special treatment as title and author information displayed in the top and bottom bars.
Development activity shows consistent maintenance with bug fixes and incremental improvements applied over time. The codebase remains actively managed with responsiveness to reported issues. The project accepts contributions and maintains documentation in a dedicated docs folder alongside the core implementation.
