-.HP
-\fB\-f\fR, \fB\-\-nofade
-.IP
-Disable color fading in 256 color mode
-.HP
-\fB\-i\fR, \fB\-\-invert
-.IP
-Swap black and white color
-.HP
-\fB\-t\fR, \fB\-\-notrans
-.IP
-Disable transparency in transparent terminal
-.HP
-\fB\-h\fR, \fB\-\-help
-.IP
-Display usage message and exit
-.HP
-\fB\-d\fR, \fB\-\-debug
-.IP
-Enable debug messages on STDERR, add multiple times to increases debug level
-.SH PRESENTATION FILES
+.SS "Input Control"
+.TP
+.IR FILE
+The input file from which the presentation is read. If no file is specified,
+or if the file name is
+.BR \- ","
+the presentation is read from standard input.
+.SS "Output Control"
+.TP
+.BR \-f ", " \-\^\-nofade
+Disable color fading in 256 color mode.
+.TP
+.BR \-i ", " \-\^\-invert
+Swap black and white color.
+.TP
+.BR \-t ", " \-\^\-notrans
+Disable transparency in transparent terminal.
+.
+.SS "Miscellaneous Options"
+.TP
+.BR \-h ", " \-\^\-help
+Display usage message and exit.
+.TP
+.BR \-d ", " \-\^\-debug
+Enable debug messages on STDERR. Add multiple times to increases debug level.
+.
+.SH MARKDOWN FORMATTING
+For a complete list of supported markups, refer the sample presentation
+(sample.md) provided alongside
+.BR mdp ,\|
+or online available at
+.IR https://github.com/visit1985/mdp .
+.SS "Slides"
+The input
+.IR FILE
+is split into multiple slides by horizontal rules. Each consisting of at least
+3
+.B \-\-\-
+or
+.B ***
+characters on a single line.
+.B This line must be prefixed by an completely empty line.
+It can also contain spaces but no other characters.
+.PP
+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.
+.
+.SS "Line-by-Line Mode"
+.SS "Block-by-Block Mode"
+A single
+.BR "<br>" ", " "<BR>" " or " "^"
+on an otherwise empty line signals