Welcome to thatlinuxbox.com Friday, March 29 2024 @ 12:46 PM UTC

Write in Markdown and use pandoc to generate documents

  • Tuesday, August 25 2015 @ 12:22 PM UTC
  • Contributed by:
  • Views: 4,086
Linux, Open Source, and Tech Stuff

Share
  • Google Plus
  • Facebook
  • Twitter
  • Reddit
  • LinkedIn
  • Digg

The last time I updated my resume I decided that it needed some major revisions. I didn't want to use a WYSIWYG editor anymore and I wanted to start tracking changes to my resume with git. After looking at various plain text file formats and markup options, and even though I have a fondness for the txt2tags syntax, I decided on Markdown. For better or worse, and I suspect due mostly to the popularity of GitHub, Markdown has become a de facto standard syntax for geeks writing documents that other people might read.

With Markdown as a source format I experimented with pandoc - a universal document converter to generate output files.

With the pandoc workflow, it is possible to write a document in plain text and then generate other types of documents such as HTML, Word processor formats (Microsoft Word docx) and PDF (via LaTeX).

So for people who insist on having a resume in Comic Sans:

or perhaps Game of Thrones is more your style (via the Artificial Uncial font):

pandoc has you covered.

The most challenging thing was figuring out the names of the fonts available, the packages needed to use them with pandoc, and the pandoc command-line syntax for activating them.

I gathered my notes and sample outputs in a github repo:

https://github.com/danstoner/pandoc_samples

I can spit out a new PDF of my resume by editing the Markdown source in my favorite text editor (emacs), commiting the changes to git, and running one command:

$ pandoc --latex-engine=xelatex -V geometry=margin=.75in -V mainfont="TeX Gyre Heros" -o danstonerresume.pdf danstonerresume.md

 

Write in Markdown and use pandoc to generate documents | 0 comments | Create New Account

The following comments are owned by whomever posted them. This site is not responsible for what they say.


User Functions

Login

Connect

thatlinuxbox.com is the home of Dan Stoner's Personal Blog, Photos, and More (opinions, rants, techno-babble, and possibly a few useful tidbits of knowledge).

Questions or Comments about this site? Contact danstoner _ at _ gmail.com.

RSS Feed for this blog

Other places to find me on the web:

Twitter

LinkedIn

GitHub

Support This Site

If you like something that you find on this site, please consider making a purchase through one of the links below or sending me an item from my Amazon Wish List.


The Clymb


Awesome VPS hosting by Linode.com