Pandoc   a universal document converter

# FAQs

On linux or OSX:

``for f in *.txt; do pandoc "\$f" -s -o "\${f%.txt}.rtf"; done``

In Windows Powershell:

``gci -r -i *.txt |foreach{\$rtf=\$_.directoryname+"\"+\$_.basename+".rtf";pandoc -f markdown -s \$_.name -o \$rtf}``

Be sure to use the `-s` or `--standalone` flag, or you just get a fragment, not a full document with the required header:

``pandoc -s -f markdown -t icml -o my.icml my.md``

By default, pandoc uses pdflatex to generate the PDF, and pdflatex doesn’t handle Chinese characters. But you can change the default to use xelatex instead. You should also make sure you’re using a font with Chinese glyphs. For example:

``pandoc -o c.pdf --pdf-engine=xelatex -V mainfont='Adobe Ming Std'``

Run the following command as admin:

``msiexec /i pandoc-VERSION.msi ALLUSERS=1``

This will put pandoc in `C:\Program Files\Pandoc`. You can install Pandoc to a different directory by setting APPLICATIONFOLDER parameter, for example:

``msiexec /i pandoc-1.11.1.msi ALLUSERS=1 APPLICATIONFOLDER="C:\Pandoc"``

The option

``-V geometry:margin=1in``

will set the margins to one inch on each side. If you don’t want uniform margins, you can do something like

``-V geometry:"top=2cm, bottom=1.5cm, left=1cm, right=1cm"``

Or

``-V geometry:"left=3cm, width=10cm"``

For more options, see the documentation for the LaTeX geometry package.

Here is a wiki page comparing the two.

For example, if you convert an image with `{width="50%"}`, the LaTeX produced will be `\includegraphics[width=0.5\textwidth,height=\textheight]`.

This output presupposes the following code in pandoc’s default latex template:

``````% Scale images if necessary, so that they will not overflow the page
% margins by default, and it is still possible to overwrite the defaults
% using explicit options in \includegraphics[width, height, ...]{}
\setkeys{Gin}{width=\maxwidth,height=\maxheight,keepaspectratio}``````

If you don’t have this in your custom template, you should add it. If we didn’t set the `height` explicitly in this way, the image would not be resized correctly unless it was being resized to smaller than its original size.

`pandoc +RTS -M30m -RTS` will limit heap memory to 30MB. When converting a document requires more than this, an out of memory error will be issued.