Blog Fiasco

January 11, 2013

A wrinkle with writing your resume in Markdown

Filed under: Linux — Tags: , , , , — bcotton @ 11:59 pm

For Sysadvent 2011, Phil Hollenback wrote an excellent post called “Write Your Resume in Markdown Already!” Ever since I read it, I’ve been using a Markdown file as the source for my resume, which gets rendered to HTML and PDF as necessary. Recently, someone using Windows tried to open the PDF of my resume in Acrobat Reader. When she did, she got errors about missing fonts. “How odd,” I thought. In the course of several job applications over the past year-plus, I hadn’t heard of any problems. (It’s possible that nobody reviewing my resume used a Windows machine to do it.)

I fired up my Windows XP virtual machine that I keep around for playing Sim City 2000 and installed Adobe Reader. I was able to reproduce the problem, which is always comforting. It didn’t shed any light on the matter, though. I actively avoid doing anything “cute” so that my resume (and other documents) can easily be read by anyone on any platform. After examining the workflow, I figured that the problem had to be in the LaTeX template used to generate the PDF.

One of the features of the template is the conditional use of packages and font settings. Since the pandoc package in Fedora 17 (version 1.9.4.2) no longer includes the markdown2pdf command in previous versions, the –xetex argument that Phil passed isn’t necessary. Removing the control structure resulted in a PDF that looked qualitatively the same, but would open on Windows. Phil’s instructions are still good overall, but they need some tweaks for newer versions of Pandoc.

Here’s a diff, for those of you who are interested:
7,9d6
< $if(xetex)$
< \usepackage{ifxetex}
< \ifxetex
15d11
< \else
18,22d13
< \fi
< $else$
< \usepackage[mathletters]{ucs}
< \usepackage[utf8x]{inputenc}
< $endif$

 

3 Comments »

  1. Mine is written in LaTeX with the moderncv class.
    This automatically handles the columnar alignment of CV entries.
    I know of someone who wrote a resume in Postscript.
    In general, however, I like Markdown and Pandoc appears to be an interesting tool.

    Comment by Jason — January 13, 2013 @ 5:38 pm

  2. Over time they’ve already managed to aid many men and women mend their unions in addition to unhappy associations by getting back again the love along with connection the couples don’t have.

    Comment by Maude — March 16, 2013 @ 3:28 pm

  3. After checking out a number of the blog articles
    on your web site, I seriously like your technique of blogging.

    I bookmarked it to my bookmark site list and will be checking back soon.
    Please check out my website as well and let me know how you feel.

    Comment by Kellee — April 17, 2013 @ 1:15 am

RSS feed for comments on this post. TrackBack URL

Leave a comment

Powered by WordPress