jekyll-resume

Jekyll Resume Theme is a lightweight Jekyll theme for publishing a resume or CV as a static website, with content stored in YAML data files.

What is the Jekyll Resume Theme?

This theme takes your resume details from YAML data files and renders them into a static HTML resume page. It runs on Jekyll, the Ruby-based static site generator, and was created by Matt Couchman. The theme is designed to stay as close to Jekyll's default structure as possible, minimizing dependency issues.

Key Features

• Data file driven — Store employment history and education details in YAML files under the _data directory; the theme renders them into sections automatically.
• Config-based site settings — Set personal details, site title, and other global options in _config.yml without touching layout files.
• Jekyll default compatible — Built around the standard Jekyll folder structure and build process, so it works with GitHub Pages and standard Jekyll deployments.
• Simple to modify — The author explicitly invites users to tear the theme apart and rebuild it to fit their needs.
• Live demo available — A working example is hosted at mattcouchman.co.uk/jekyll-resume so you can preview the layout before installing.

Who is it for?

• Job seekers with technical skills — Publish a clean, static resume site that is easy to update through YAML files rather than hand-editing HTML.
• Jekyll users — Anyone already running a Jekyll site can drop this theme in and start with a resume page that matches the default build.
• GitHub Pages users — Because the theme follows default Jekyll conventions, it can be hosted for free on GitHub Pages with minimal configuration.

What can you do with it?

• Create a personal resume site — Fill in your work history and education, run jekyll build, and deploy the static output anywhere.
• Maintain a version-controlled CV — Keep your resume data in YAML text files, track changes with git, and regenerate the site with each update.
• Host on GitHub Pages — Push the repository to GitHub and enable Pages to get a live resume URL.

How does it work?

1. Install Jekyll and clone or copy the theme files.
2. Edit _config.yml with your name, contact info, and site settings.
3. Replace the contents of the jobs and education YAML files in _data with your own history.
4. Run jekyll build or jekyll serve to generate the site locally or publish it.

FAQ

Is the Jekyll Resume Theme free to use?

The project is hosted publicly on GitHub and the author states you are free to tear it apart and rebuild it as you wish. There is no price listed.

How do I update the resume content?

Edit the YAML files in the _data directory. Each job or education entry is a structured record that the theme loops over to output the resume sections.

Does this theme require a database?

No. Since it is a Jekyll static site, all content is stored in YAML files and rendered at build time. No database or server-side processing is needed.