Skip to content

Instantly share code, notes, and snippets.

@ilessing
Last active April 26, 2024 22:15
Show Gist options
  • Save ilessing/7ff705de0f594510e463146762cef779 to your computer and use it in GitHub Desktop.
Save ilessing/7ff705de0f594510e463146762cef779 to your computer and use it in GitHub Desktop.
getting pandoc to generate PDF from Markdown on MacOS

Using Pandoc to generate PDFs from Markdown

on a Mac running macOS 10.13.4

To install the needed components you can use Homebrew

Two Components are needed:

  1. Pandoc
  2. PDFLaTex

Install instructions:

Use Homebrew to install pandoc:

brew install pandoc

Then use Homebrew to install the PDFLaTex program.

brew install --cask basictex

You should now have all the needed components but it won't work until the pdflatex executable is available in your PATH environment variable. To configure this my technique is to sym link the executable to a directory already in my PATH.

ln -s -v /Library/TeX/texbin/pdflatex /usr/local/bin/pdflatex

Now if I enter which pdflatex on the command line the system responds:

/usr/local/bin/pdflatex

And now I'm able to generate a PDF from my Markdown file with this command:

pandoc file.md -s -o file.pdf

Pandoc will take your Markdown file, tranform it to TeX and then run it through the PDFLaTex program to output a PDF file.


  • Date: 2018-05-22

  • System info: MacBook Pro, macOS 10.13.4

Written with StackEdit

@marvingabler
Copy link

Thanks, must have been tired 🤦

@michaelmcguire
Copy link

Slight update:

Since the instructions use brew and on Apple Silicon Macs, the default location has changed, I recommend linking to pdflatex with the following command instead to get it in the $PATH

ln -s -v /Library/TeX/texbin/pdflatex /opt/homebrew/bin/pdflatex

Trying to link into /usr/local/bin required sudo, at least on my machine.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment