Pandoc for PDFs
Check the docs for full installation instructions, but basically you need to install Pandoc and a LaTex distribution. Pandoc converts your Markdown and your Tex / LaTex distribution does the typesetting to create PDFs. Here is everything necessary on Ubuntu Linux:
sudo apt install pandoc texlive texlive-fonts-extra texlive-xetex
If you install MiKTeX on Windows (your LaTeX distro) plus Pandoc, most of these commands should work–MiKTeX’s package manager will pop up asking to install what ever is necessary.
Note: this was written on Linux using Pandoc 18.104.22.168, it doesn’t work quite the same on Pandoc 2+ on Windows. I will update when I get a chance…
To create a basic PDF, use the
-o output flag and a file name with
pandoc -o output.pdf input.md
For writing your content Pandoc supports an extended version of markdown syntax with many enhancements such as footnotes and tables (similar to GitHub Flavor Markdown). If you include a YAML metadata block at the top of your file, the standard fields will be translated into LaTex elements (title, date, author, etc).
To tweak your PDF layout / typesetting, you can pass LaTex variables to Pandoc using the
-V variable flag (see docs for all LaTex variable options).
If you know LaTex, you can get fancy right away and use existing templates.
However, you can also use a few very simple options to spruce up the defaults.
For example, the default margin is very large, so you might want to use:
pandoc -V geometry=margin=1.25in -o output.pdf input.md
This will use the LaTex package
geometry to set all the margins to 1.25 inch.
You could set each margin individually with geometry options margin-left, margin-right, margin-top, or margin-bottom.
To change the font I usually use the XeLaTex engine, since it can use any normal font installed on your system. First, you need to figure out the correct names for installed fonts. Use this command:
fc-list : family | cut -f1 -d"," | sort
The full name listed will be passed as a variable.
Alternatively, open LibreOffice Writer and look through the font names.
However, the variable is picky about the exact name used, so check against the official name as given in
The command looks like:
pandoc --pdf-engine=xelatex -V geometry=margin=1.25in -V mainfont="Noto Sans" -o output.pdf input.md
Note: older versions of Pandoc use
--pdf-engine, which is likely if you installed Pandoc from a distro repository.
You can also use the pdfLaTex engine, which requires specifically prepared LaTex fonts (usually stored with a
Preparing and using the fonts requires a bit of LaTex savvy (in theory you can use lots of cool fonts, FontCatalogue).
texlive-fonts-extra package contains a few ready to go options.
The command looks like:
pandoc --latex-engine=pdflatex -V fontfamily="electrum" -V geometry=margin=1.25in -o output.pdf input.md
Font size can be controlled using
-V fontsize=12pt, however, the default template only supports sizes 10, 11, or 12.
More sizes are supported using the extsize package (8pt, 9pt, 10pt, 11pt, 12pt, 14pt, 17pt, 20pt) which can be used by adding
-V documentclass=extarticle plus the desired fontsize (if extsize is not installed, your LaTeX distribution should automatically fetch it).
Now we are getting a lot of commandline arguments to keep track of… You can simplify by declaring the LaTeX options as YAML metadata at the top of the document instead. For example:
--- documentclass: extarticle mainfont: Noto Sans fontsize: 14pt ---
For my basic purposes, that is plenty of control, but of course you can go much further by learning more about LaTex. Check danstoner for samples of PDF creation, Practical Typography for system font suggestions, and the Pandoc User Guide for more info.