nhemsley / markdown-cv

a simple template to write your CV in a readable markdown file and use CSS to publish/print it.

Home Page:elipapa.github.io/markdown-cv

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool


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.


To start, simply fork the markdown-cv repo

and then edit directly in github the index.md file

adding your skills, jobs and education.

To transform your plain text CV into a beautiful looking HTML page and share it you then have two options:

1) Using Github Pages to publish it online

  1. 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
  2. Create a new branch called gh-pages (which will then be a copy of master)
  3. 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.

2) Build it locally and print a PDF

  1. install jekyll on your computer. gem install jekyll will do for most users.
  2. Clone your fork on your computer
  3. Type jekyll serve and you'll be able to see your CV on your local host (the default address is http://localhost:4000).
  4. You can edit the index.md file and see changes live in your browser.
  5. To print a PDF, just press Print. Print and web CSS media queries should take care of the styling.

Change the style

The included CSS renders CV in different 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, one needs to simply change the variable in the _config.yml file.

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


Eliseo Papa (Twitter/GitHub/website).

Eliseo Papa


MIT License


a simple template to write your CV in a readable markdown file and use CSS to publish/print it.


License:MIT License


Language:CSS 96.4%Language:HTML 3.6%