@@ -127,92 +127,49 @@ will convert `source.txt` from the local encoding to UTF-8, then
127127convert it to HTML, then convert back to the local encoding,
128128putting the output in `output.html`.
129129
130−The wrapper scripts (described below) automatically convert the input
131−from the local encoding to UTF-8 before running them through `pandoc`,
132−then convert the output back to the local encoding.
133−
134130Wrappers
135131========
136132
137−Three wrapper scripts, `markdown2pdf`, `html2markdown`, and
138−`hsmarkdown`, are included in the standard Pandoc installation. (The
139−Windows binary package does not include `html2markdown`, which is
140−a POSIX shell script. It does include portable Haskell versions of
141−`markdown2pdf` and `hsmarkdown`.)
142−
143−1. `markdown2pdf` produces a PDF file from markdown-formatted
144− text, using `pandoc` and `pdflatex`. The default
145− behavior of `markdown2pdf` is to create a file with the same
146− base name as the first argument and the extension `pdf`; thus,
147− for example,
148−
149− markdown2pdf sample.txt endnotes.txt
150−
151− will produce `sample.pdf`. (If `sample.pdf` exists already,
152− it will be backed up before being overwritten.) An output file
153− name can be specified explicitly using the `-o` option:
154−
155− markdown2pdf -o book.pdf chap1 chap2
156−
157− If no input file is specified, input will be taken from stdin.
158− All of `pandoc`'s options will work with `markdown2pdf` as well.
159−
160− `markdown2pdf` assumes that `pdflatex` is in the path. It also
161− assumes that the following LaTeX packages are available:
162− `unicode`, `fancyhdr` (if you have verbatim text in footnotes),
163− `graphicx` (if you use images), `array` (if you use tables),
164− and `ulem` (if you use strikeout text). If they are not already
165− included in your LaTeX distribution, you can get them from
166− [CTAN]. A full [TeX Live] or [MacTeX] distribution will have all of
167− these packages.
168−
169−2. `html2markdown` grabs a web page from a file or URL and converts
170− it to markdown-formatted text, using `tidy` and `pandoc`.
171−
172− All of `pandoc`'s options will work with `html2markdown` as well.
173− In addition, the following special options may be used.
174− The special options must be separated from the `html2markdown`
175− command and any regular Pandoc options by the delimiter `--`:
176−
177− html2markdown -o out.txt -- -e latin1 -g curl google.com
178−
179− The `-e` or `--encoding` option specifies the character encoding
180− of the HTML input. If this option is not specified, and input
181− is not from stdin, `html2markdown` will attempt to determine the
182− page's character encoding from the "Content-type" meta tag.
183− If this is not present, UTF-8 is assumed.
184−
185− The `-g` or `--grabber` option specifies the command to be used to
186− fetch the contents of a URL:
187−
188− html2markdown -g 'curl --user foo:bar' www.mysite.com
189−
190− If this option is not specified, `html2markdown` searches for an
191− available program (`wget`, `curl`, or a text-mode browser) to fetch
192− the contents of a URL.
193−
194− `html2markdown` requires [HTML Tidy], which must be in the path.
195− It uses [`iconv`] for character encoding conversions; if `iconv`
196− is absent, it will still work, but it will treat everything as UTF-8.
197−
198−3. `hsmarkdown` is designed to be used as a drop-in replacement for
199− `Markdown.pl`. It forces `pandoc` to convert from markdown to
200− HTML, and to use the `--strict` flag for maximal compliance with
201− official markdown syntax. (All of Pandoc's syntax extensions and
202− variants, described below, are disabled.) No other command-line
203− options are allowed. (In fact, options will be interpreted as
204− filenames.)
205−
206− As an alternative to using the `hsmarkdown` script, the
207− user may create a symbolic link to `pandoc` called `hsmarkdown`.
208− When invoked under the name `hsmarkdown`, `pandoc` will behave
209− as if the `--strict` flag had been selected, and no command-line
210− options will be recognized. However, this approach does not work
211− under Cygwin, due to problems with its simulation of symbolic
212− links.
133+`markdown2pdf`
134+--------------
135+
136+The standard Pandoc installation includes `markdown2pdf`, a wrapper
137+around `pandoc` and `pdflatex` that produces PDFs directly from markdown
138+sources. The default behavior of `markdown2pdf` is to create a file with
139+the same base name as the first argument and the extension `pdf`; thus,
140+for example,
141+
142+ markdown2pdf sample.txt endnotes.txt
143+
144+will produce `sample.pdf`. (If `sample.pdf` exists already,
145+it will be backed up before being overwritten.) An output file
146+name can be specified explicitly using the `-o` option:
147+
148+ markdown2pdf -o book.pdf chap1 chap2
149+
150+If no input file is specified, input will be taken from stdin.
151+All of `pandoc`'s options will work with `markdown2pdf` as well.
152+
153+`markdown2pdf` assumes that `pdflatex` is in the path. It also
154+assumes that the following LaTeX packages are available:
155+`unicode`, `fancyhdr` (if you have verbatim text in footnotes),
156+`graphicx` (if you use images), `array` (if you use tables),
157+and `ulem` (if you use strikeout text). If they are not already
158+included in your LaTeX distribution, you can get them from
159+[CTAN]. A full [TeX Live] or [MacTeX] distribution will have all of
160+these packages.
161+
162+`hsmarkdown`
163+------------
164+
165+A user who wants a drop-in replacement for `Markdown.pl` may create
166+a symbolic link to the `pandoc` executable called `hsmarkdown`. When
167+invoked under the name `hsmarkdown`, `pandoc` will behave as if the
168+`--strict` flag had been selected, and no command-line options will be
169+recognized. However, this approach does not work under Cygwin, due to
170+problems with its simulation of symbolic links.
213171
214172[Cygwin]: http://www.cygwin.com/
215−[HTML Tidy]: http://tidy.sourceforge.net/
216173[`iconv`]: http://www.gnu.org/software/libiconv/
217174[CTAN]: http://www.ctan.org "Comprehensive TeX Archive Network"
218175[TeX Live]: http://www.tug.org/texlive/
@@ -562,8 +519,7 @@ Pandoc's markdown vs. standard markdown
562519
563520In parsing markdown, Pandoc departs from and extends [standard markdown]
564521in a few respects. Except where noted, these differences can
565−be suppressed by specifying the `--strict` command-line option or by
566−using the `hsmarkdown` wrapper.
522+be suppressed by specifying the `--strict` command-line option.
567523
568524[standard markdown]: http://daringfireball.net/projects/markdown/syntax
569525 "Markdown syntax description"