markdown-cv

A curriculum vitae maintained in plain text and rendered to HTML and PDF using CSS.

For more details, see the project page, or the blog post on why I switched to markdown for my CV.

Distribution

To transform your plain text CV into a beautiful and shareable HTML page, you have two options:

Delete the existing gh-pages branch from your fork. It will only contain this webpage. You can either use git or the Github web interface.
Create a new branch called gh-pages.
Head to yourusername.github.io/markdown-cv to see your CV live.

Any change you want to make to your CV from then on would have to be done on the gh-pages branch and will be immediately rendered by Github Pages.

To install jekyll, run gem install bundler jekyll from the command line.
Clone your fork of markdown-cv to your local machine.
Type jekyll serve to render your CV at http://localhost:4000.
You can edit the index.md file and see the changes live in your browser.
To print a PDF, press ⌘ + p. Print and web CSS media queries should take care of the styling.

The included CSS will render your CV in two styles:

kjhealy the original default, inspired by kjhealy's vita template.
davewhipp is a tweaked version of kjhealy, with bigger fonts and dates right aligned.

To change the default style, simply change the variable in the _config.yml file.

Any other styling is possible. More CSS style contributions and forks are welcome!