md2man - manual page flavoring for the markdown(7) file format
md2man makes the markdown(7) file format friendly for writing UNIX manual pages by extending its syntax, semantics, and assumed processing extensions.
md2man extends markdown(7) syntax by defining three kinds of paragraphs.
This is a
normal
paragraph.
This is a
tagged
paragraph.
This is an
indented
paragraph.
This
is another
normal
paragraph.
Paragraphs whose lines are all indented by exactly zero or one additional spaces are considered to be "normal paragraphs". For example:
This is a
normal
paragraph.
This
is another
normal
paragraph.
Paragraphs whose first line is indented by less than two additional spaces and whose subsequent lines are uniformly indented by exactly two additional spaces are considered to be "tagged paragraphs". For example:
This is a
tagged
paragraph.
Paragraphs whose lines are all uniformly indented by exactly two additional spaces are considered to be "indented paragraphs". For example:
This is an
indented
paragraph.
md2man extends markdown(7) semantics by treating top-level headings specially.
The first top-level heading (H1) found in the input is considered to be the
.TH directive in roff(7), which defines the UNIX manual page's header and
footer. Any subsequent top-level headings are treated as second-level (H2).
md2man enables the following Redcarpet extensions while reading markdown(7):