Tired of using LaTeX to make your CV look pretty? Can’t remember how to set margins in your TeX file? Refusing to compromise and “just use Word”?

markdown-cv is a simple template to list all your accomplishments in a readable Markdown file. It uses CSS to style your text into a stylish web page. It can also be printed as PDF.

what does that mean?

Write your CV like this…

and use jekyll or github pages to make it look like this..


To start, simply fork the markdown-cv repo

and then edit directly in github the 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:

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 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.

Build it locally

  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 file and see changes live in your browser.

Whether you used Github Pages or a local installation of Jekyll, to print a PDF just press Print in your browser. Print specific CSS media queries will take care of the styling.

is this the only style available?

For the moment, yes. The included CSS renders CV in a style inspired by kjhealy’s vita template, but any styling is possible. Contributions and forks are welcome!


Eliseo Papa (Twitter/GitHub/website).

Eliseo Papa


MIT License