.TH MD2MAN 1 "2011\-12\-06" "1.0.1"
.SH NAME
.PP
md2man \- convert 
.BR markdown (7) 
into 
.BR roff (7)
.SH SYNOPSIS
.PP
\fB\fCmd2man\fR [\fIOPTION\fP]... [\fIFILE\fP]
.SH DESCRIPTION
.PP
md2man
.UR https://github.com/sunaku/md2man
.UE
converts 
.BR markdown (7) 
input from the given \fIFILE\fP into 
.BR roff (7) 
using
Redcarpet2
.UR https://github.com/tanoku/redcarpet
.UE
and then prints the result to the standard output stream.  If
\fIFILE\fP is not given, then the standard input stream is read in its place.
.SS Document Format
.PP
The following additional semantics are attached to 
.BR markdown (7):
.RS
.IP \(bu 2
There can be at most one top\-level heading (H1).  It is emitted as \fB\fC.TH\fR
in the 
.BR roff (7) 
output, specifying the UNIX man page's header and footer.
.IP \(bu 2
Paragraphs whose lines are all uniformly indented by two spaces are
considered to be "indented paragraphs".  They are unindented accordingly
before emission as \fB\fC.IP\fR in the 
.BR roff (7) 
output.
.IP \(bu 2
Paragraphs whose subsequent lines (all except the first) are uniformly
indented by two spaces are considered to be a "tagged paragraphs".  They
are unindented accordingly before emission as \fB\fC.TP\fR in the 
.BR roff (7) 
output.
.RE
.SS Markdown Extensions
.PP
The following Redcarpet2
.UR https://github.com/tanoku/redcarpet
.UE
extensions for 
.BR markdown (7) 
are enabled:
.RS
.IP \(bu 2
tables
.IP \(bu 2
autolink
.IP \(bu 2
superscript
.IP \(bu 2
strikethrough
.IP \(bu 2
no_intra_emphasis
.IP \(bu 2
fenced_code_blocks
.RE
.SH OPTIONS
.TP
\fB\fC-h\fR, \fB\fC--help\fR
Display this help manual using 
.BR man (1).
.SH SEE ALSO
.PP
.BR markdown (7), 
.BR roff (7)