This is an openshift web service for generating a pdf from markdown. Simply append the GitHub file URL to:

https://pdfdoc-purpleidea.rhcloud.com/pdf/

and you'll get sent a PDF of the markdown document. For example, to get a PDF of this README, you can go to: https://pdfdoc-purpleidea.rhcloud.com/pdf/https://github.com/purpleidea/pdfdoc/blob/master/README.md

Please read the INSTALL file for instructions on getting this installed.

This was built because existing PDF generators make ugly documents! Only pandoc seems to make good looking ones. I looked at gitprint, and phantomjs, but the output is terrible! I also wanted an excuse to hack on an openshift app.

(Send your questions as a patch to this FAQ! I'll review it, merge it, and respond by commit with the answer.)

This started out as mdpdf, as in markdown-to-pdf. As we all know, an MD is a doctor, so it became pdf doctor. This name didn't make much sense, so it was then named pdfdoc. This makes a whole lot of sense because it makes pdfs for documentation!

Because I'm a terrible graphic designer! Please feel free to send me one for the project. Thanks in advance!

As mentioned above, I started this project to scratch an itch, and to try out openshift. My web frontend and bootstrap skills are surely terrible! Please feel free to send in patches!

Once again, I wrote this as a quick POC hack, and to scratch an itch. Please voice your complains in the form of constructive patches :)

I don't think so, but there is room for improvement, and it's more interesting if you I address all the haters up front :)

Send me your patches! Yup. Do it :)

Happy hacking!