colinw520 / resume.md

Write your resume in Markdown, style it with CSS, output to HTML and PDF

resume.md

Write your resume in Markdown, style it with CSS, output to HTML and PDF.

Prerequisites

• Python ≥ 3.6
• python-markdown (pip install markdown)
• Optional, required for PDF output: Google Chrome or Chromium

Usage

1. Download resume.py, resume.md and resume.css (or make a copy of this repository by using the template, forking, or cloning).

2. Edit resume.md (the placeholder text is taken with thanks from the JSON Resume Project)

3. Run python3 resume.py to build resume.html and resume.pdf.

   • Use --no-html or --no-pdf to disable HTML or PDF output.

   • Use --chrome-path=/path/to/chrome if resume.py cannot find your Chrome or Chromium executable.

Customization

Edit resume.css to change the appearance of your resume. The default style is extremely generic, which is perhaps what you want in a resume, but CSS gives you a lot of flexibility. See, e.g. The Tech Resume Inside-Out for good advice about what a resume should look like (and what it should say).

Change the appearance of the PDF version (without affecting the HTML version) by adding rules under the @media print CSS selector.

Change the margins and paper size of the PDF version by editing the @page CSS rule.

python-markdown is by default a very basic markdown compiler, but it has a number of optional extensions that you may want to enable (by adding to the list of extensions here). attr_list in particular may by useful if you are editing the CSS.