@@ -56,15 +56,13 @@ The wrapper script `markdown2pdf` requires
56 - `pandoc` (which must be in the PATH)
56 - `pandoc` (which must be in the PATH)
57 - a POSIX-compliant shell
57 - a POSIX-compliant shell
58 - `pdflatex`, which should be part of any [LaTeX] distribution
58 - `pdflatex`, which should be part of any [LaTeX] distribution
59− - the [unicode] and [fancyvrb] LaTeX packages, which are included
59+ - the following LaTeX packages (available from [CTAN], if they
60− in many LaTeX distributions.[^1] If your installation of LaTeX
60+ are not already included in your LaTeX distribution):
61− does not include these packages, you will get an error (complaining
61+ + `unicode` (for UTF8 characters)
62− about missing `ucs.sty` or `fancyvrb.sty`) when you try to compile
62+ + `fancyvrb` (for verbatim text in footnotes)
63− a LaTeX file produced by Pandoc, or when you use the `markdown2pdf`
63+ + `graphicx` (for images)
64− script (described below). If this happens, install the [unicode] and
64+ + `array` (for tables)
65− [fancyvrb] packages package from [CTAN]. (Get the zip file from CTAN
65+ + `ulem` (for strikeout text)
66− and unpack it into `~/texmf/tex/latex/`. You may also need to run
67− `mktexlsr` or `texhash` before the files can be found by TeX.)
69The wrapper script `hsmarkdown` requires only a POSIX-compliant shell.
67The wrapper script `hsmarkdown` requires only a POSIX-compliant shell.
@@ -72,12 +70,6 @@ The wrapper script `hsmarkdown` requires only a POSIX-compliant shell.
72[HTML Tidy]: http://tidy.sourceforge.net/
70[HTML Tidy]: http://tidy.sourceforge.net/
73[`iconv`]: http://www.gnu.org/software/libiconv/
71[`iconv`]: http://www.gnu.org/software/libiconv/
74[CTAN]: http://www.ctan.org "Comprehensive TeX Archive Network"
72[CTAN]: http://www.ctan.org "Comprehensive TeX Archive Network"
75−[unicode]: http://www.ctan.org/tex-archive/macros/latex/contrib/unicode/
76−[fancyvrb]: http://www.ctan.org/tex-archive/macros/latex/contrib/fancyvrb/
78−[^1]: The [unicode] package allows LaTeX to process UTF-8 characters.
79−[fancyvrb] allows code blocks and verbatim text to be used within
82Using Pandoc
74Using Pandoc
83============
75============
@@ -383,6 +375,29 @@ which allows only the following characters to be backslash-escaped:
384 \`*_{}[]()>#+-.!
376 \`*_{}[]()>#+-.!
378+Subscripts and superscripts
379+---------------------------
381+Superscripts may be written by surrounding the superscripted text by `^`
382+characters; subscripts may be written by surrounding the subscripted
383+text by `~` characters. Thus, for example,
385+ H~2~O is a liquid. 2^10^ is 1024.
387+If the superscripted or subscripted text contains spaces, these spaces
388+must be escaped with backslashes. (This is to prevent accidental
389+superscripting and subscripting through the ordinary use of `~` and `^`.)
390+Thus, if you want the letter P with 'a cat' in subscripts, use
391+`P~a\ cat`, not `P~a cat~`.
396+To strikeout a section of text with a horizontal line, begin and end it
397+with `~~`. Thus, for example,
399+ This ~~is deleted text.~~
@@ -551,7 +566,7 @@ Simple tables look like this:
552The headers and table rows must each fit on one line. Column
567The headers and table rows must each fit on one line. Column
553alignments are determined by the position of the header text relative
568alignments are determined by the position of the header text relative
554−to the dashed line below it:[^2]
569+to the dashed line below it:[^1]
556 - If the dashed line is flush with the header text on the right side
571 - If the dashed line is flush with the header text on the right side
557 but extends beyond it on the left, the column is right-aligned.
572 but extends beyond it on the left, the column is right-aligned.
@@ -562,7 +577,7 @@ to the dashed line below it:[^2]
562 - If the dashed line is flush with the header text on both sides,
577 - If the dashed line is flush with the header text on both sides,
563 the default alignment is used (in most cases, this will be left).
578 the default alignment is used (in most cases, this will be left).
565−[^2]: This scheme is due to Michel Fortin, who proposed it on the
580+[^1]: This scheme is due to Michel Fortin, who proposed it on the
566 Markdown discussion list: <http://six.pairlist.net/pipermail/markdown-discuss/2005-March/001097.html>
581 Markdown discussion list: <http://six.pairlist.net/pipermail/markdown-discuss/2005-March/001097.html>
568The table must end with a blank line. Optionally, a caption may be
583The table must end with a blank line. Optionally, a caption may be
@@ -745,7 +760,7 @@ escaped with a backslash if needed.
745If you pass the `-m` (`--asciimathml`) option to `pandoc`, it will
760If you pass the `-m` (`--asciimathml`) option to `pandoc`, it will
746embed the [ASCIIMathML] script in the resulting HTML. This will
761embed the [ASCIIMathML] script in the resulting HTML. This will
747cause LaTeX math to be displayed as formulas in better
762cause LaTeX math to be displayed as formulas in better
748−browsers.[^3]
763+browsers.[^2]
750[ASCIIMathML]: http://www1.chapman.edu/~jipsen/asciimath.html
765[ASCIIMathML]: http://www1.chapman.edu/~jipsen/asciimath.html
@@ -767,7 +782,7 @@ You can also use LaTeX environments. For example,
767Note, however, that material between the begin and end tags will
782Note, however, that material between the begin and end tags will
768be interpreted as raw LaTeX, not as markdown.
783be interpreted as raw LaTeX, not as markdown.
770−[^3]: If you are serving several pages that use ASCIIMathML, it will be
785+[^2]: If you are serving several pages that use ASCIIMathML, it will be
771 more efficient to link to an external copy of `ASCIIMathML.js`
786 more efficient to link to an external copy of `ASCIIMathML.js`
772 instead of using the `-m|--asciimathml` option to embed it directly
787 instead of using the `-m|--asciimathml` option to embed it directly
773 in web pages. To do this, get a copy of `ASCIIMathML.js` from the
788 in web pages. To do this, get a copy of `ASCIIMathML.js` from the