I have recently started learning Markdown for use with documentation, and need to print out a few of my Markdown pages. I would like to use a command-line, Terminal, etc. utility that allows me to convert Github-flavored Markdown to PDF. It needs to have proper syntax highlighting and should not look horrible. Thanks for any help.

  • 1
    The syntax coloring on GitHub is not part of GitHub Flavored Markdown. At least as far as I know. Dec 16, 2013 at 12:51
  • @OliverSalzburg Github uses Linguist to provide syntax highlighting. Dec 16, 2013 at 13:37
  • 1
    @dillmo, Convert to HTML first, then use Chrome to print-to-pdf.
    – Pacerier
    Feb 18, 2016 at 20:30
  • Update 2022:If anyone stumbles upon this and you don't want to install any libraries and just want to download a hassle-free PDF or HTML, just go to dillinger.io and paste the markdown content and then from the top menu, you can simply export it as a PDF or HTML. It preserves the formatting, is free, and no need to install any library or tool.
    – Xonshiz
    Jun 21, 2022 at 16:00
  • Copy the rendered content from a markdown viewer (in my case it was Simplenote) and paste it to Google Docs. Then choose File -> Download -> PDF Document Jul 19, 2022 at 11:14

15 Answers 15


I've had success using grip to display markdown in Chrome and then use Chrome's "Save as PDF" option in the Print dialog.

pip install grip  
grip your_markdown.md

grip will render the markdown on localhost:5000 or similar (ex: go to http://localhost:5000/) - just edit away and refresh the browser. Print when ready.

This gave a more reliable representation than pandoc and was lighter weight than installing latex (required by pandoc for pdf generation).

The print is not command-line in this answer, but still found this easier/more reliable (looked 100% like Github for a long document including relatively linked images and code highlighting).

  • 3
    this is easy enough.
    – s2t2
    Sep 5, 2015 at 0:21
  • 35
    grip your_markdown.md --export your_markdown.html is useful option here. Exports it to the html file, which can then be printed from the command line using something like wkhtmltopdf.
    – Luke Exton
    Sep 12, 2015 at 1:27
  • 11
    Alternatively you can download (free!) Atom (atom.io), open your file in Atom, use control + shift+ M to view it in preview, save as html, then open the html in your Chrome browser and save as pdf. Jan 4, 2016 at 19:54
  • 7
    This does come with the Github-like frame around it. Is there a way to print to PDF, removing the borders / title bar (i.e. printing everything inside the frame)?
    – Joost
    Mar 7, 2016 at 14:05
  • 8
    You can use Pandoc with the light-weight wkhtmltopdf instead of latex like this: pandoc README-Template.md --from=gfm --pdf-engine=wkhtmltopdf --output README.pdf
    – Asme Just
    Apr 13, 2018 at 19:15

You can also use Node.js based markdown-pdf

npm install -g markdown-pdf
markdown-pdf /path/to/markdown
  • 2
    This is pretty awesome and really easy. The link issue comes from the html5 boilerplate's print css which you can just comment out or override in your own stylesheet. Nov 8, 2015 at 3:14
  • 2
    Would like to add that this has out-of-the-box Unicode support, which is very nice.
    – Niek
    Mar 13, 2017 at 19:00
  • 1
    @AbhishekBhatia This is the first result when I Googled "npm introduction": smalljs.org/package-managers/npm. It's just a file buried in node_modules once you install it.
    – jpmc26
    Aug 16, 2017 at 18:51
  • 5
    This can also be used with npx in place of npm to avoid having to install globally for one-off usage: npx markdown-pdf /path/to/markdown
    – vulpxn
    Dec 28, 2020 at 3:05
  • 1
    This tool takes HTML code literally, so if you have any HTML in your markdown, this sadly won't work.
    – baltermia
    Sep 28, 2021 at 10:19

Take a look at pandoc. It does have syntax highlighting. It might require you making (minor) changes to your document since it has its own flavour of markdown and I don't know how closely it matches the GitHub flavour.

  • 5
    Thanks. Running pandoc -h did return support for GitHub Flavored Markdown, so I'm marking this question as resolved.
    – dillmo
    Feb 11, 2014 at 23:49
  • 4
    I attempted to install pandoc on Fedora Linux and ran into a dependency nightmare - mainly LaTex related. My advice would be to skip pandoc and try other options first
    – IanB
    Aug 13, 2015 at 1:13
  • 1
    For those who use non-ASCII letters and get them missing: add font options to pandoc, like these: --variable mainfont="Liberation Serif" --variable sansfont="Liberation Sans"
    – gluk47
    Sep 13, 2016 at 20:18
  • 8
    If someone is looking for just the commands: sudo apt install pandoc texlive-latex-recommended texlive-xetex texlive-luatex pandoc-citeproc etoolbox wkhtmltopdf (on Ubuntu, probably not all necessary), then pandoc --variable urlcolor=cyan myfile.md -o myfile.pdf Jun 5, 2017 at 15:31
  • 1
    This is the only thing that worked fully with anchors intact and other extra features: pandoc -f markdown -t html5 on-premise-admin-guide.md -o test.pdf worked after installing via homebrew and installing wkhtml2pdf.
    – james-see
    Oct 30, 2019 at 3:10

There's an online converter available at http://www.markdowntopdf.com
This provides syntax highlighting out of the box and is the simplest solution I've seen so far. It also correctly handles other features specific to GFM e.g. tables.

  • 9
    Doesn't handle images in separate files.
    – Larry K
    Oct 16, 2017 at 19:11
  • Using this service requires making an account.
    – buddemat
    Nov 9, 2023 at 9:47

For those with Linux, use pandoc.


sudo apt install pandoc texlive-latex-extra

Yes, you need -extra package because of fonts.


pandoc --from markdown -o output.pdf my-file.md
  • 5
    Didn't include any images, links and ignored things like <font color="red"> though
    – derHugo
    Jan 11, 2019 at 13:08
  • Today, I see pandoc DOES include images that are inserted the markdown way. However, it ignores html markup, such as <font... or <img.... I find pandoc can write html5 output, but none of the pdf converter tools make that into a beautiful PDF. I've got a copy of Typora that is able to convert the markdown to PDF with a battle, but dont know how they get that done.
    – pauljohn32
    May 30, 2023 at 20:38

Update 2021-11: The project was abandoned, the domain is now hosting ads or malware.

If the markdown file was hosted on github repository, gitprint was an interesting option to create pdf / print.

All you needed to do is to replace github.com by gitprint.com in the URL.

Unfortunately, it does not work on markdown gists, and works only with markdown files at the repository.

  • 6
    It does not work with images either. :(
    – Adam Arold
    Sep 2, 2014 at 13:12
  • 1
    ...and is poorly formated :(
    – Moebius
    Apr 22, 2016 at 19:20
  • Interesting option. Pros: external links are maintained and accessible from the output. Cons: output is black and white, anchor links are removed, external links are not visually indicated because they are b&w.
    – rodey
    Jan 10, 2018 at 14:49
  • 2
    ...aaaand it's an online casino.
    – slim
    Aug 13, 2021 at 19:42

As I stated in my comment, Github uses Linguist to provide syntax highlighting. On Github, you can use this to specify syntax highlighting like so:

require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html

Unfortunately, there's no good way to convert Markdown directly to a PDF file with syntax highlighting.



If you have vim, you can easily achieve syntax highlighting by running the following from a terminal:

vim -c hardcopy -c quit /path/to/file.ps

Or inside of vim:

:hardcopy >/path/to/file.ps

This will produce a PostScript file that can be converted to pdf using, for example, ps2pdf:

ps2pdf /path/to/file.ps


If you'd like instead to go the route of HTML or LaTeX, you could try Source-highlight instead. A list of all languages supported by Source-highlight can be found here.

A few example Source-highlight commands include:

source-highlight -s java -f html -i Hello.java -o Hello1.html
source-highlight -s java -f html --input Hello.java --output Hello2.html --doc
source-highlight -s java -f html -i Hello.java -o Hello3.html --title "Happy Java with java2html :-)" --tab 3

Using this input file

And each outputting their own respective HTML file:


Further examples of Source-highlight usage can be found here


Vim, ps2pdf (provided by Ghostscript) and Source-highlight are all available via Cygwin.


I had the most luck with VSCode and the Markdown PDF extension. The online converters screwed up the encoding for my files or inserted watermarks in the header.


  1. Install the extension
  2. Open your MD file with VSCode, make sure Markdown highlighting is enabled
  3. Open the command palette (F1), type export and select markdown-pdf: Export (pdf)

NB: The extension installs and uses a local version of Chromium in the background.

There are several options to control formatting, they are all explained on the website linked above

  • This worked for me on Windows, but I had to add "markdown-pdf.breaks": true to the settings JSON file to see new lines in the PDF. Also "markdown-pdf.displayHeaderFooter": true to hide some information which was added to the PDF header and footer. And "markdown-pdf.styles": [ "C:\\Users\\<USERNAME>\\Documents\\markdown-pdf.css" ] to change the CSS based on github.com/yzane/vscode-markdown-pdf/blob/master/styles/… because I did not like the default color for inline code.
    – hb20007
    Aug 6, 2021 at 15:51

I have recently created a service to convert markdown documents to PDF. It supports Github flavoured markdown as well as syntax highlighting. The service is located at: http://markdown2pdf.com

  • doesn't work with zip file : couldn't find the markdown file in the archive while there is one.
    – Moebius
    Apr 22, 2016 at 19:26
  • got "error in conversion to pdf". Using markdowntopdf.com instead from kevgathuku
    – Shadi
    Oct 20, 2017 at 15:22

I'm still looking for a command-line solution which produces results this high-quality [Update: I came up with a pandoc command which uses CSS for formatting, and looks pretty good: pandoc -f gfm -t html5 --metadata pagetitle="test.md" --css github.css test.md -o test.pdf--see my other answer here now!], but:

My preferred technique, because it looks so good, is to use the Markdown Viewer plugin in Chrome. It works really well, and looks surprisingly similar to GitHub markdown! Just open your markdown file in Chrome with this plugin installed and activated, then use the menus to print and save as a PDF right from Chrome.

Markdown Viewer boasts the following features (emphasis added):

✔ Renders local and remote URLs
✔ Granular access to remote origins
✔ Multiple markdown parsers
✔ Full control over the compiler options
✔ Themes (including GitHub theme)
GitHub Flavored Markdown (GFM)
Auto reload on file change
Syntax highlighted code blocks
✔ Table of Contents (TOC)
MathJax and Emoji support
Remembers scroll position
✔ Markdown Content-Type detection
✔ URL detection using RegExp
✔ Toggle Content Security Policy (CSP)
✔ Override page encoding
✔ Settings synchronization
✔ Raw and rendered markdown views
Free and Open Source

Example Markdown file

Here is a sample markdown file, which is a snippet from my example markdown demo file in my project here:


## 1.1. Align images left, right, or centered, with NO WORD WRAP:


**Align left:**
<p align="left" width="100%">
    <img width="33%" src="https://i.stack.imgur.com/RJj4x.png"> 

**Align center:**
<p align="center" width="100%">
    <img width="33%" src="https://i.stack.imgur.com/RJj4x.png"> 

**Align right:**
<p align="right" width="100%">
    <img width="33%" src="https://i.stack.imgur.com/RJj4x.png"> 

Produces this:

**Align left:**
<p align="left" width="100%">
    <img width="33%" src="https://i.stack.imgur.com/RJj4x.png"> 

**Align center:**
<p align="center" width="100%">
    <img width="33%" src="https://i.stack.imgur.com/RJj4x.png"> 

**Align right:**
<p align="right" width="100%">
    <img width="33%" src="https://i.stack.imgur.com/RJj4x.png"> 

If you'd like to set the text itself to left, center, or right, you can include the text inside the `<p>` element as well, as regular HTML, like this:

<p align="right" width="100%">
    This text is also aligned to the right.<br>
    <img width="33%" src="https://i.stack.imgur.com/RJj4x.png"> 

Markdown Viewer output:

The above markdown file produces this output directly in my Chrome browser when viewed with the Markdown Viewer plugin installed and on. Notice it has language-aware syntax highlighting for code blocks, nice-looking, greyed code backgrounds, and reasonable column widths for output content.

Its output looks really nice, and is almost identical to GitHub's markdown output!

enter image description here

It supports themes too. See the "GitHub" theme is selected here, for instance. Just click the little m plugin icon in the top right of your Chrome browser to choose Markdown Viewer settings you want:

enter image description here

grip output:

Contrast this to the output from grip, which I think doesn't look nearly as good. grip doesn't have syntax highlighting for code blocks, greyed background for code, nor reasonable column widths for the output content. On a wide monitor, it takes up the whole width.

On Linux Ubuntu:

sudo apt update
sudo apt install grip
grip test.md

Then Ctrl + click on the url it gives you, to open the output in your browser. Ex: at http://localhost:6419/. Here's the grip-rendered output I see in Chrome:

enter image description here

See also:

  1. [my answer] How to convert Markdown + CSS -> PDF?

I refined this snippet for my personal needs:

# sudo apt install grip wkhtmltopdf


printf "Converting $MD to $PDF on port $PORT\n"
printf "Waiting $DELAY seconds for server to start...\n"

grip "$MD" localhost:$PORT &
sleep $DELAY
wkhtmltopdf http://localhost:$PORT "$PDF"
kill $(ps -eo pid,command | grep grip | grep -v grep | awk '{print $1}')

Save as /usr/local/bin/md2pdf and sudo chmod +x /usr/local/bin/md2pdf afterwards.


  • md2pdf converts README.md to README.md.pdf

  • md2pdf foo.md converts foo.md to foo.md.pdf

  • md2pdf foo.md bar.pdf converts foo.md to bar.pdf

  • Add --export to grip call so it exports to a HTML file instead of running a webserver and you might skip sleeping and replace kill with just removal of the temporary HTML file.
    – Najki
    Jun 15, 2021 at 12:16

Mine solution: convert markdown with pandoc to html (don't forget to use css for pandoc to show table borders), then open it with libreoffice, choose an option export as pdf.

NB: neither of mentioned here and on the Internet solutions worked for me: 1) browser-based solutions (i.e. grip) are adding excess info, like page numbers, which I didn't manage to remove, 2) pandoc convertage to pdf is broken, for me it generates an empty table (perhaps because of unicode, and yes, I configured it to use xetex), 3) site based solutions (i.e. gitprint.com) are also adding redundant things, like github-like margins, whereas I need just a simple table I generated with awk!

  • 1
    pandoc should work for you with options like --variable mainfont="Liberation Serif" --variable sansfont="Liberation Sans"
    – gluk47
    Sep 13, 2016 at 20:17
  • @gluk47 cool, that works!
    – Hi-Angel
    Sep 19, 2016 at 14:10
  • I can recommend this page for converting markdown to PDF (or for printing) markdownprint.com.
    – Johan O
    Apr 21, 2018 at 13:56
  • @JohanO markdownprint.com seems to be down
    – derHugo
    Jan 11, 2019 at 13:10

I have tried several chrome plugins and online converters.
MDtr2PDF is the best one. It supports Github-flavoured-markdown and unicode.

  • 2
    Does it support images stored in other files?
    – Larry K
    Oct 16, 2017 at 19:12
  • 2
    No longer seems to be working, and is not TLS-secured. May 16, 2019 at 14:47
  • 3
    This link is dead Jan 30, 2020 at 17:24

I just convert from HTML instead. This works for my needs:


I found that in general Markdown is not a good format to convert to PDF, as it doesnt have native CSS support. Here is the script I use:

require 'dompdf/autoload.inc.php';
use Dompdf\Dompdf;

$dompdf = new Dompdf();
$s_in = file_get_contents('index.html');

$s_out = $dompdf->output();
file_put_contents('index.pdf', $s_out);

This solution just needs PHP (25 MB) and DomPdf (4 MB), so quite lightweight compared to other options.


MDPDF - Markdown to PDF converter.

A command line markdown to pdf converter with support for page headers, footers, and custom stylesheets. Mdpdf is incredibly configurable and has a JavaScript API for more extravogant usage.


Install globally to use from the command line:

npm install mdpdf -g


$ mdpdf --help

   $ mdpdf <source> [<destination>] [options]

<source> must be a markdown file, with the extension '.md'.

   $ mdpdf README.md
   $ mdpdf README.md --style=styles.css --header=header.hbs --h-height=22mm
   $ mdpdf README.md --footer=footer.hbs --f-height=22mm --debug
   $ mdpdf README.md --border-left=30mm

   --style=<filename>           A single css stylesheet you wish to apply to the PDF
   --header=<filename>          A HTML (.html) file to inject into the header of the PDF
   --h-height=<height>          The height of the header section
   --footer=<filename>          A HTML (.html) file to inject into the footer of the PDF
   --f-height=<height>          The height of the footer section
   --border=<size>              Border (top, left, bottom, right; default: 20mm)
   --border-top=<size>          Top border (default: 20mm)
   --border-left=<size>         Left border (default: 20mm)
   --border-bottom=<size>       Bottom border (default: 20mm)
   --border-right=<size>        Right border (default: 20mm)
   --gh-style                   Enable default gh-styles, when --style is used
   --no-emoji                   Disables emoji conversions
   --no-highlight               Disables syntax highlighting
   --debug                      Save the generated html for debugging
   --help                       Display this menu
   --version                    Display the application version
   --format=<format>            PDF size format: A3, A4, A5, Legal, Letter, Tabloid (Default: A4)
   --orientation=<orientation>  PDF orientation: portrait or landscape (Default: portrait)

  Length parameters (<height> and <size>) require a unit. Valid units are mm, cm, in and px.

Global Settings:
      You can also set a global default stylesheet by setting the MDPDF_STYLES environment variable as the path to your single css stylesheet. The --style flag will override this.

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .