aboutsummaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
Diffstat (limited to 'man')
-rw-r--r--man/man1/html2markdown.161
-rw-r--r--man/man1/latex2markdown.134
-rw-r--r--man/man1/markdown2html.135
-rw-r--r--man/man1/markdown2latex.135
-rw-r--r--man/man1/markdown2pdf.186
-rw-r--r--man/man1/markdown2rst.11
-rw-r--r--man/man1/markdown2rtf.11
-rw-r--r--man/man1/markdown2s5.11
-rw-r--r--man/man1/pandoc.1126
-rw-r--r--man/man1/rst2markdown.11
-rw-r--r--man/man1/web2markdown.182
11 files changed, 222 insertions, 241 deletions
diff --git a/man/man1/html2markdown.1 b/man/man1/html2markdown.1
index 6cdba595c..7b82576d6 100644
--- a/man/man1/html2markdown.1
+++ b/man/man1/html2markdown.1
@@ -1,60 +1 @@
-.TH HTML2MARKDOWN 1 "November 21, 2006" Pandoc "User Manuals"
-.SH NAME
-html2markdown \- converts HTML to markdown-formatted text
-.SH SYNOPSIS
-\fBhtml2markdown\fR [\fIoptions\fR] [\fIinput\-file\fR or \fIURL\fR]
-[\fB\-\-\fR] [\fIpandoc\-opts\fR]
-.SH DESCRIPTION
-\fBhtml2markdown\fR converts \fIinput\-file\fR or \fIURL\fR (or text
-from STDIN) from HTML to markdown\-formatted plain text.
-If a URL is specified, \fBhtml2markdown\fR uses an available program
-(e.g. wget, w3m, lynx or curl) to fetch its contents. Output is sent
-to STDOUT.
-.PP
-\fBhtml2markdown\fR is a wrapper for \fBpandoc\fR.
-.SH OPTIONS
-.TP
-.B \-h
-Show usage message.
-.TP
-.B \-e \fIencoding\fR
-Assume the character encoding \fIencoding\fR in reading the HTML.
-(Note: \fIencoding\fR will be passed to \fBiconv\fR; a list of
-available encodings may be obtained using `\fBiconv \-l\fR'.)
-If the \fB\-e\fR option is not specified, the encoding will be
-determined as follows: If input is from STDIN, the local encoding
-will be assumed. Otherwise, \fBhtml2markdown\fR will try to
-extract the character encoding from the "Content-type" meta tag.
-If no character encoding is specified in this way, UTF-8 will be
-assumed for a URL argument, and the local encoding will be assumed
-for a file argument.
-.TP
-.B \-g \fIcommand\fR
-Use \fIcommand\fR to fetch the contents of a URL. (By default,
-\fBhtml2markdown\fR searches for an available program or text-based
-browser to fetch the contents of a URL.) For example:
-.IP
-html2markdown \-g 'wget \-\-user=foo \-\-password=bar' mysite.com
-.TP
-.B \-n
-Disable automatic fetching of contents when URLs are specified as
-arguments.
-.TP
-.I pandoc\-opts
-Any options appearing after \fIinput\-file\fR or \fIURL\fR on the
-command line will be passed directly to \fBpandoc\fR. If no
-\fIinput-file\fR or \fIURL\fR is specified, these options must
-be preceded by ` \fB\-\-\fR '. (In other cases, ` \fB\-\-\fR ' is
-optional.) See \fBpandoc\fR(1) for a list of options that may be used.
-Example:
-.IP
-html2markdown input.txt \-\- \-R
-.SH "SEE ALSO"
-\fBpandoc\fR(1),
-\fBmarkdown2html\fR(1),
-\fBmarkdown2latex\fR(1),
-\fBlatex2markdown\fR(1),
-\fBmarkdown2pdf\fR(1),
-\fBiconv\fR(1)
-.SH AUTHOR
-John MacFarlane and Recai Oktas
+.so man1/pandoc.1
diff --git a/man/man1/latex2markdown.1 b/man/man1/latex2markdown.1
index 6e7e9e033..7b82576d6 100644
--- a/man/man1/latex2markdown.1
+++ b/man/man1/latex2markdown.1
@@ -1,33 +1 @@
-.TH LATEX2MARKDOWN 1 "November 21, 2006" Pandoc "User Manuals"
-.SH NAME
-latex2markdown \- converts LaTeX to markdown\-formatted text
-.SH SYNOPSIS
-\fBlatex2markdown\fR [\fIoptions\fR] [\fIinput\-file\fR]
-[\fB\-\-\fR] [\fIpandoc\-opts\fR]
-.SH DESCRIPTION
-\fBlatex2markdown\fR converts \fIinput\-file\fR
-(or text from STDIN) from LaTeX to markdown\-formatted plain text.
-Output is sent to STDOUT.
-.PP
-\fBlatex2markdown\fR is a wrapper for \fBpandoc\fR.
-.SH OPTIONS
-.TP
-.B \-h
-Show usage message.
-.TP
-.I pandoc\-opts
-Any options appearing after \fIinput\-file\fR on the command line
-will be passed directly to \fBpandoc\fR. If no \fIinput-file\fR
-is specified, these options must be preceded by ` \fB\-\-\fR '.
-(In other cases, ` \fB\-\-\fR ' is optional.) See \fBpandoc\fR(1)
-for a list of options that may be used. Example:
-.IP
-latex2markdown input.txt \-\- \-R
-.SH "SEE ALSO"
-\fBpandoc\fR(1),
-\fBmarkdown2html\fR(1),
-\fBhtml2markdown\fR(1),
-\fBmarkdown2latex\fR(1),
-\fBmarkdown2pdf\fR(1)
-.SH AUTHOR
-John MacFarlane and Recai Oktas
+.so man1/pandoc.1
diff --git a/man/man1/markdown2html.1 b/man/man1/markdown2html.1
index 33d063321..7b82576d6 100644
--- a/man/man1/markdown2html.1
+++ b/man/man1/markdown2html.1
@@ -1,34 +1 @@
-.TH MARKDOWN2HTML 1 "November 21, 2006" Pandoc "User Manuals"
-.SH NAME
-markdown2html \- converts markdown\-formatted text to HTML
-.SH SYNOPSIS
-\fBmarkdown2html\fR [\fIoptions\fR] [\fIinput\-file\fR]...
-[\fB\-\-\fR] [\fIpandoc\-opts\fR]
-.SH DESCRIPTION
-\fBmarkdown2html\fR converts \fIinput\-file\fR
-(or text from STDIN) from markdown\-formatted plain text to HTML.
-If multiple files are specified, they will be combined to make a single
-HTML document. Output is sent to STDOUT.
-.PP
-\fBmarkdown2html\fR is a wrapper for \fBpandoc\fR.
-.SH OPTIONS
-.TP
-.B \-h
-Show usage message.
-.TP
-.I pandoc\-opts
-Any options appearing after \fIinput\-file\fR... on the command line
-will be passed directly to \fBpandoc\fR. If no \fIinput-file\fR
-is specified, these options must be preceded by ` \fB\-\-\fR '.
-(In other cases, ` \fB\-\-\fR ' is optional.) See \fBpandoc\fR(1)
-for a list of options that may be used. Example:
-.IP
-markdown2html input.txt \-\- \-\-css=main.css \-S
-.SH "SEE ALSO"
-\fBpandoc\fR(1),
-\fBhtml2markdown\fR(1),
-\fBmarkdown2latex\fR(1),
-\fBlatex2markdown\fR(1),
-\fBmarkdown2pdf\fR(1)
-.SH AUTHOR
-John MacFarlane and Recai Oktas
+.so man1/pandoc.1
diff --git a/man/man1/markdown2latex.1 b/man/man1/markdown2latex.1
index 3039192d1..7b82576d6 100644
--- a/man/man1/markdown2latex.1
+++ b/man/man1/markdown2latex.1
@@ -1,34 +1 @@
-.TH MARKDOWN2LATEX 1 "November 21, 2006" Pandoc "User Manuals"
-.SH NAME
-markdown2latex \- converts markdown-formatted text to LaTeX
-.SH SYNOPSIS
-\fBmarkdown2latex\fR [\fIoptions\fR] [\fIinput\-file\fR]...
-[\fB\-\-\fR] [\fIpandoc\-opts\fR]
-.SH DESCRIPTION
-\fBmarkdown2latex\fR converts \fIinput\-file\fR (or text from STDIN)
-from markdown\-formatted plain text to LaTeX. If multiple files are
-specified, they will be combined to make a single LaTeX document.
-Output is sent to STDOUT.
-.PP
-\fBmarkdown2latex\fR is a wrapper for \fBpandoc\fR.
-.SH OPTIONS
-.TP
-.B \-h
-Show usage message.
-.TP
-.I pandoc\-opts
-Any options appearing after \fIinput\-file\fR... on the command line
-will be passed directly to \fBpandoc\fR. If no \fIinput-file\fR
-is specified, these options must be preceded by ` \fB\-\-\fR '.
-(In other cases, ` \fB\-\-\fR ' is optional.) See \fBpandoc\fR(1)
-for a list of options that may be used. Example:
-.IP
-markdown2latex input.txt \-\- \-\-custom\-header=letterhead.tex
-.SH "SEE ALSO"
-\fBpandoc\fR(1),
-\fBmarkdown2html\fR(1),
-\fBhtml2markdown\fR(1),
-\fBlatex2markdown\fR(1),
-\fBmarkdown2pdf\fR(1)
-.SH AUTHOR
-John MacFarlane and Recai Oktas
+.so man1/pandoc.1
diff --git a/man/man1/markdown2pdf.1 b/man/man1/markdown2pdf.1
index 99aa50a28..c15131a42 100644
--- a/man/man1/markdown2pdf.1
+++ b/man/man1/markdown2pdf.1
@@ -1,43 +1,71 @@
-.TH MARKDOWN2PDF 1 "November 21, 2006" Pandoc "User Manuals"
+.TH MARKDOWN2PDF 1 "December 15, 2006" Pandoc "User Manuals"
.SH NAME
markdown2pdf \- converts markdown-formatted text to PDF, using pdflatex
.SH SYNOPSIS
-\fBmarkdown2pdf\fR [\fIoptions\fR] [\fB\-o\fR \fIoutput-file\fR]
-[\fIinput-file\fR]... [\fB\-\-\fR] [\fIpandoc\-opts\fR]
+\fBmarkdown2pdf\fR [\fIoptions\fR] [\fIinput-file\fR]...
.SH DESCRIPTION
-\fBmarkdown2pdf\fR converts \fIinput\-file\fR (or text from STDIN) from
-markdown\-formatted plain text to PDF, using \fBpdflatex\fR. If no output
-filename is specified, the name of the output file is derived from the
-input file; thus, for example, if the input file is \fIhello.txt\fR,
-the output file will be \fIhello.pdf\fR. If the input is read from STDIN
-and no output filename is specified, the output file will be named
-\fIstdin.pdf\fR. If multiple input files are specified, they will be
-concatenated before conversion, and the name of the output file will be
-derived from the first input file.
+\fBmarkdown2pdf\fR converts \fIinput\-file\fR (or text from standard
+input) from markdown\-formatted plain text to PDF, using \fBpdflatex\fR.
+If no output filename is specified, the name of the output file is
+derived from the input file; thus, for example, if the input file
+is \fIhello.txt\fR, the output file will be \fIhello.pdf\fR. If
+the input is read from STDIN and no output filename is
+specified, the output file will be named \fIstdin.pdf\fR. If
+multiple input files are specified, they will be concatenated before
+conversion, and the name of the output file will be derived from
+the first input file.
.PP
-\fBmarkdown2pdf\fR is a wrapper for \fBpandoc\fR.
+Input is assumed to be in the UTF\-8 character encoding. If your
+local character encoding is not UTF\-8, you should pipe input and
+output through \fBiconv\fR:
+.IP
+.B iconv \-t utf\-8 input.txt | pandoc | iconv \-f utf\-8
+.PP
+\fBmarkdown2pdf\fR assumes that the 'unicode' package
+is in latex's search path. If this package is not included in your
+latex setup, it can be obtained from <http://ctan.org>.
+.PP
+\fBmarkdown2pdf\fR is a wrapper around \fBmarkdown2latex\fR.
.SH OPTIONS
.TP
-.B \-h
-Show usage message.
+.B \-o FILE, \-\-output=FILE
+Write output to \fIFILE\fR.
.TP
-.B \-o \fIoutput-file\fR
-Specify name of output (PDF) file.
+.B \-p, \-\-preserve-tabs
+Preserve tabs instead of converting them to spaces.
.TP
-.I pandoc\-opts
-Any options appearing after \fIinput\-file\fR... on the command line
-will be passed directly to \fBpandoc\fR. If no \fIinput-file\fR
-is specified, these options must be preceded by ` \fB\-\-\fR '.
-(In other cases, ` \fB\-\-\fR ' is optional.) See \fBpandoc\fR(1)
-for a list of options that may be used. Example:
-.IP
-markdown2pdf input.txt \-\- \-\-custom\-header=letterhead.tex
+.B \-\-tab-stop=\fITABSTOP\fB
+Specify tab stop (default is 4).
+.TP
+.B \-R, \-\-parse-raw
+Parse untranslatable LaTeX environments as raw LaTeX,
+instead of ignoring them.
+.TP
+.B \-N, \-\-number-sections
+Number section headings in LaTeX output. (Default is not to number them.)
+.TP
+.B \-H \fIFILE\fB, \-\-include-in-header=\fIFILE\fB
+Include (LaTeX) contents of \fIFILE\fR at the end of the header. Implies
+\fB\-s\fR.
+.TP
+.B \-B \fIFILE\fB, \-\-include-before-body=\fIFILE\fB
+Include (LaTeX) contents of \fIFILE\fR at the beginning of the document body.
+.TP
+.B \-A \fIFILE\fB, \-\-include-after-body=\fIFILE\fB
+Include (LaTeX) contents of \fIFILE\fR at the end of the document body.
+.TP
+.B \-C \fIFILE\fB, \-\-custom-header=\fIFILE\fB
+Use contents of \fIFILE\fR
+as the LaTeX document header (overriding the default header, which can be
+printed using '\fBpandoc \-D latex\fR'). Implies \fB-s\fR.
+.TP
+.B \-v, \-\-version
+Print version.
+.TP
+.B \-h, \-\-help
+Show usage message.
.SH "SEE ALSO"
\fBpandoc\fR(1),
-\fBmarkdown2html\fR(1),
-\fBhtml2markdown\fR(1),
-\fBmarkdown2latex\fR(1),
-\fBlatex2markdown\fR(1),
\fBpdflatex\fR(1)
.SH AUTHOR
John MacFarlane and Recai Oktas
diff --git a/man/man1/markdown2rst.1 b/man/man1/markdown2rst.1
new file mode 100644
index 000000000..7b82576d6
--- /dev/null
+++ b/man/man1/markdown2rst.1
@@ -0,0 +1 @@
+.so man1/pandoc.1
diff --git a/man/man1/markdown2rtf.1 b/man/man1/markdown2rtf.1
new file mode 100644
index 000000000..7b82576d6
--- /dev/null
+++ b/man/man1/markdown2rtf.1
@@ -0,0 +1 @@
+.so man1/pandoc.1
diff --git a/man/man1/markdown2s5.1 b/man/man1/markdown2s5.1
new file mode 100644
index 000000000..7b82576d6
--- /dev/null
+++ b/man/man1/markdown2s5.1
@@ -0,0 +1 @@
+.so man1/pandoc.1
diff --git a/man/man1/pandoc.1 b/man/man1/pandoc.1
index 5f632de90..82c9ae321 100644
--- a/man/man1/pandoc.1
+++ b/man/man1/pandoc.1
@@ -1,18 +1,23 @@
-.TH PANDOC 1 "November 21, 2006" Pandoc "User Manuals"
+.TH PANDOC 1 "December 15, 2006" Pandoc "User Manuals"
.SH NAME
-pandoc \- general markup converter
+pandoc, markdown2html, markdown2latex, markdown2rst, markdown2rtf,
+markdown2s5, html2markdown2, latex2markdown, rst2markdown \- general
+markup converter
.SH SYNOPSIS
\fBpandoc\fR [\fIoptions\fR] [\fIinput\-file\fR]...
.SH DESCRIPTION
-\fIPandoc\fR converts files from one markup format to another. It can
+\fBPandoc\fR converts files from one markup format to another. It can
read markdown and (subsets of) reStructuredText, HTML, and LaTeX, and
it can write markdown, reStructuredText, HTML, LaTeX, RTF, and S5 HTML
slide shows.
.PP
-If no \fIinput\-file\fR is specified, input is read from STDIN. Otherwise,
-the \fIinput\-files\fR are concatenated (with a blank line between each)
-and used as input. Output goes to STDOUT. If you want output to a file,
-use shell redirection:
+If no \fIinput\-file\fR is specified, input is read from STDIN.
+Otherwise, the \fIinput\-files\fR are concatenated (with a blank
+line between each) and used as input. Output goes to standard
+output. If you want output to a file, use the \fB\-o\fR option or
+shell redirection:
+.IP
+.B pandoc \-o output.html input.txt
.IP
.B pandoc input.txt > output.html
.PP
@@ -25,6 +30,19 @@ formats can be specified using command\-line options. For example,
converts \fIchap1.tex\fR from LaTeX to markdown\-formatted plain text.
See below for a detailed list of command\-line options.
.PP
+For convenience, eight variant programs are available:
+\fBmarkdown2html\fR (same as \fBpandoc \-w html\fR),
+\fBmarkdown2latex\fR (same as \fBpandoc \-w latex\fR),
+\fBmarkdown2rst\fR (same as \fBpandoc \-w rst\fR),
+\fBmarkdown2rtf\fR (same as \fBpandoc \-w rtf\fR),
+\fBmarkdown2s5\fR (same as \fBpandoc \-w s5\fR),
+\fBhtml2markdown\fR (same as \fBpandoc \-r html \-w markdown\fR),
+\fBlatex2markdown\fR (same as \fBpandoc \-r latex \-w markdown\fR),
+and \fBrst2markdown\fR (same as \fBpandoc \-r rst \-w markdown\fR).
+These programs take an appropriately restricted subset of \fBpandoc\fR's
+options. (Run them with the \fB-h\fR flag for a full list of allowed
+options.)
+.PP
\fIPandoc\fR uses the UTF\-8 character encoding for both input and output.
If your local character encoding is not UTF\-8, you should pipe input
and output through \fBiconv\fR:
@@ -33,61 +51,58 @@ and output through \fBiconv\fR:
.SH OPTIONS
.TP
-.B \-v, \-\-version
-Print version.
-.TP
-.B \-h, \-\-help
-Show usage message.
-.TP
-.B \-f FORMAT, \-r FORMAT, \-\-from=FORMAT, \-\-read=FORMAT
+.B \-f \fIFORMAT\fB, \-r \fIFORMAT\fB, \-\-from=\fIFORMAT\fB, \-\-read=\fIFORMAT\fB
Specify input format.
.I FORMAT
can be
-.I native
+.B native
(native Haskell),
-.I markdown
+.B markdown
(markdown or plain text),
-.I rst
+.B rst
(reStructuredText),
-.I html
+.B html
(HTML),
or
-.I latex
+.B latex
(LaTeX).
.TP
-.B \-t FORMAT, \-w FORMAT, \-\-to=FORMAT, \-\-write=FORMAT
+.B \-t \fIFORMAT\fB, \-w \fIFORMAT\fB, \-\-to=\fIFORMAT\fB, \-\-write=\fIFORMAT\fB
Specify output format.
.I FORMAT
can be
-.I native
+.B native
(native Haskell),
-.I markdown
+.B markdown
(markdown or plain text),
-.I rst
+.B rst
(reStructuredText),
-.I html
+.B html
(HTML),
-.I latex
+.B latex
(LaTeX),
-.I s5
+.B s5
(S5 HTML and javascript slide show),
or
-.I rtf
+.B rtf
(rich text format).
.TP
.B \-s, \-\-standalone
Produce output with an appropriate header and footer (e.g. a
standalone HTML, LaTeX, or RTF file, not a fragment).
.TP
+.B \-o FILE, \-\-output=FILE
+Write output to \fIFILE\fR instead of STDOUT.
+.TP
.B \-p, \-\-preserve-tabs
Preserve tabs instead of converting them to spaces.
.TP
-.B \-\-tab-stop=TABSTOP
+.B \-\-tab-stop=\fITABSTOP\fB
Specify tab stop (default is 4).
.TP
.B \-R, \-\-parse-raw
-Parse untranslatable HTML codes and LaTeX environments as raw HTML or
-LaTeX, instead of ignoring them.
+Parse untranslatable HTML codes and LaTeX environments as raw HTML
+or LaTeX, instead of ignoring them.
.TP
.B \-S, \-\-smartypants
Use smart quotes, dashes, and ellipses in HTML output.
@@ -99,41 +114,50 @@ Use ASCIIMathML to display embedded LaTeX math in HTML output.
Make list items in S5 display incrementally (one by one).
.TP
.B \-N, \-\-number-sections
-Number section headings in LaTeX output. (Default is not to number them.)
+Number section headings in LaTeX output. (Default is not to number
+them.)
.TP
-.B \-c CSS, \-\-css=CSS
+.B \-c \fICSS\fB, \-\-css=\fICSS\fB
Link to a CSS style sheet.
.I CSS
is the pathname of the style sheet.
.TP
-.B \-H FILENAME, \-\-include-in-header=FILENAME
-Include contents of \fIFILENAME\fR at the end of the header. Implies
+.B \-H \fIFILE\fB, \-\-include-in-header=\fIFILE\fB
+Include contents of \fIFILE\fR at the end of the header. Implies
\fB\-s\fR.
.TP
-.B \-B FILENAME, \-\-include-before-body=FILENAME
-Include contents of \fIFILENAME\fR at the beginning of the document body.
+.B \-B \fIFILE\fB, \-\-include-before-body=\fIFILE\fB
+Include contents of \fIFILE\fR at the beginning of the document
+body.
.TP
-.B \-A FILENAME, \-\-include-after-body=FILENAME
-Include contents of \fIFILENAME\fR at the end of the document body.
+.B \-A \fIFILE\fB, \-\-include-after-body=\fIFILE\fB
+Include contents of \fIFILE\fR at the end of the document body.
.TP
-.B \-\-custom-header=FILENAME
-Use contents of \fIFILENAME\fR
-as the document header (overriding the default header, which can be
-printed by using the \fB\-D\fR option). Implies
-\fB-s\fR.
+.B \-C \fIFILE\fB, \-\-custom-header=\fIFILE\fB
+Use contents of \fIFILE\fR as the document header (overriding the
+default header, which can be printed by using the \fB\-D\fR option).
+Implies \fB-s\fR.
.TP
-.B \-D FORMAT, \-\-print-default-header=FORMAT
-Print the default header for \fIFORMAT\fR
-(\fIhtml, s5, latex, markdown, rst, rtf\fR).
+.B \-D \fIFORMAT\fB, \-\-print-default-header=\fIFORMAT\fB
+Print the default header for \fIFORMAT\fR (\fIhtml, s5, latex,
+markdown, rst, rtf\fR).
.TP
-.B \-T STRING, \-\-title-prefix=STRING
+.B \-T \fISTRING\fB, \-\-title-prefix=\fISTRING\fB
Specify \fISTRING\fR as a prefix to the HTML window title.
+.TP
+.B \-d, \-\-debug
+Print debugging information (names of input and output files) to
+STDERR. Write output to STDOUT, even if an output file was specified
+using the \fB\-o\fR option.
+.TP
+.B \-v, \-\-version
+Print version.
+.TP
+.B \-h, \-\-help
+Show usage message.
.SH "SEE ALSO"
-\fBmarkdown2html\fR(1),
-\fBhtml2markdown\fR(1),
-\fBmarkdown2latex\fR(1),
-\fBlatex2markdown\fR(1),
+\fBweb2markdown\fR(1),
\fBmarkdown2pdf\fR(1),
\fBiconv\fR(1)
diff --git a/man/man1/rst2markdown.1 b/man/man1/rst2markdown.1
new file mode 100644
index 000000000..7b82576d6
--- /dev/null
+++ b/man/man1/rst2markdown.1
@@ -0,0 +1 @@
+.so man1/pandoc.1
diff --git a/man/man1/web2markdown.1 b/man/man1/web2markdown.1
new file mode 100644
index 000000000..a570cfc97
--- /dev/null
+++ b/man/man1/web2markdown.1
@@ -0,0 +1,82 @@
+.TH WEB2MARKDOWN 1 "December 15, 2006" Pandoc "User Manuals"
+.SH NAME
+web2markdown \- converts HTML to markdown-formatted text
+.SH SYNOPSIS
+\fBweb2markdown\fR [\fIoptions\fR] [\fIinput\-file\fR or \fIURL\fR]
+.SH DESCRIPTION
+\fBweb2markdown\fR converts \fIinput\-file\fR or \fIURL\fR (or text
+from STDIN) from HTML to markdown\-formatted plain text.
+If a URL is specified, \fBweb2markdown\fR uses an available program
+(e.g. wget, w3m, lynx or curl) to fetch its contents. Output is sent
+to STDOUT unless an output file is specified using the \fB\-o\fR
+option.
+.PP
+\fBweb2markdown\fR uses the character encoding specified in the
+"Content-type" meta tag. If this is not present, or if input comes
+from STDIN, UTF-8 is assumed. A character encoding may be specified
+explicitly using the \fB\-e\fR option.
+.PP
+\fBweb2markdown\fR is a wrapper for \fBhtml2markdown\fR.
+.SH OPTIONS
+.TP
+.B \-s, \-\-standalone
+Include title, author, and date information (if present) at the
+top of markdown output.
+.TP
+.B \-o FILE, \-\-output=FILE
+Write output to \fIFILE\fR instead of STDOUT.
+.TP
+.B \-p, \-\-preserve-tabs
+Preserve tabs instead of converting them to spaces.
+.TP
+.B \-\-tab-stop=\fITABSTOP\fB
+Specify tab stop (default is 4).
+.TP
+.B \-R, \-\-parse-raw
+Parse untranslatable HTML codes as raw HTML.
+.TP
+.B \-H \fIFILE\fB, \-\-include-in-header=\fIFILE\fB
+Include contents of \fIFILE\fR at the end of the header. Implies
+\fB\-s\fR.
+.TP
+.B \-B \fIFILE\fB, \-\-include-before-body=\fIFILE\fB
+Include contents of \fIFILE\fR at the beginning of the document body.
+.TP
+.B \-A \fIFILE\fB, \-\-include-after-body=\fIFILE\fB
+Include contents of \fIFILE\fR at the end of the document body.
+.TP
+.B \-C \fIFILE\fB, \-\-custom-header=\fIFILE\fB
+Use contents of \fIFILE\fR
+as the document header (overriding the default header, which can be
+printed using '\fBpandoc \-D markdown\fR'). Implies
+\fB-s\fR.
+.TP
+.B \-v, \-\-version
+Print version.
+.TP
+.B \-h, \-\-help
+Show usage message.
+.TP
+.B \-e \fIencoding\fR
+Assume the character encoding \fIencoding\fR in reading HTML.
+(Note: \fIencoding\fR will be passed to \fBiconv\fR; a list of
+available encodings may be obtained using `\fBiconv \-l\fR'.)
+If the \fB\-e\fR option is not specified and input is not from
+STDIN, \fBweb2markdown\fR will try to extract the character encoding
+from the "Content-type" meta tag. If no character encoding is
+specified in this way, or if input is from STDIN, UTF-8 will be
+assumed.
+.TP
+.B \-g \fIcommand\fR
+Use \fIcommand\fR to fetch the contents of a URL. (By default,
+\fBweb2markdown\fR searches for an available program or text-based
+browser to fetch the contents of a URL.) For example:
+.IP
+web2markdown \-g 'wget \-\-user=foo \-\-password=bar' mysite.com
+
+.SH "SEE ALSO"
+\fBpandoc\fR(1),
+\fBhtml2markdown\fR(1),
+\fBiconv\fR(1)
+.SH AUTHOR
+John MacFarlane and Recai Oktas