Switch branches/tags
Nothing to show
Clone or download
Failed to load latest commit information.
_layouts add davewhipp style Jun 14, 2018
media upload print Jun 14, 2018
.gitignore sass cache persists for solo theme Jun 14, 2018
LICENSE mit license Jan 16, 2017
README.md add some docs Jun 14, 2018
_config.yml add davewhipp style Jun 14, 2018
index.md Update index.md Jan 15, 2017



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