Manage Your Resume With Markdown

Based on Mike White's resume.

Overview

A collection of files and scripts to manage your resume in the Markdown lightweight text markup language. Write your resume as a specially formatted text file and produce PDF and HTML versions easily.

This started with a TeX header file and build script. I've modified it to use a Makefile and a XeTeX template.

I switched to XeTeX so I could specify better fonts than the defaults that LaTeX generates.

Requirements

I run all of this on a mac although it should work fine under Linux too. Required packages:

• Emacs
  • Just kidding. You don't need emacs to use this but it is pretty awesome.
  • Markdown-mode - the best way to edit Markdown files with Emacs.
• Pandoc - convert Markdown files to various formats such as HTML and PDF.
  • Install on your Mac via Macports.
• TeX/LaTeX/XeTeX - required for Pandoc to create PDFs.
  • Install with Macports.
• Perl
  • The best scripting language ever written.
  • Required by the resume-uploader script.
  • You also need File::Homedir, install with sudo cpan "File::HomeDir"
• Awesomeness
  • You bring this yourself, not available prepackaged.

Usage

Run make in the resume directory. This builds html and pdf versions of my resume. It also invokes resume-uploader to upload the various files to my website.

resume-uploader is a fairly generic perl script that uses Net::FTP to upload the files. It checks if the files on the server are older than the ones being uploaded and only uploads newer files. It also only uploads files which already exists on the server.

There are just a couple of config settings in the uploader script - change them as appropriate for your setup. That script should work with just about any ftp server.

Note that resume-uploader assumes the use of a ~/.netrc file to store your login info. The format of this file is:

machine www.example.com login username password XXXXXXXX
default login anonymous password user@site

Your ~/.netrc must be mode 600.

I call my finished files resume-phil.xxx to fit an existing naming scheme. You probably want to adjust the makefile and scripts to call them something else.

TODO

It would be pretty amazing if someone figured out how to generate word documents from Markdown. Maybe use pandoc to create RTF?

Conclusion

This setup works very well for my needs and collects a number of scattered bits of info about markdown and pandoc resume generation. Thanks especially to the inspiration of Mike White's resume which showed me this all was actually possible.