ResumeCards

ResumeCards is a Markdown-based resume generator built with Jekyll that produces a single-page resume viewable on mobile and desktop and savable as a PDF. Created by Elle Kasai, the project is released under the MIT License but is no longer maintained.

What is ResumeCards?

ResumeCards turns Markdown files into a styled resume page. You write your resume content as YAML front matter and Markdown inside Jekyll post files named _posts/card-[1-9].md, and ResumeCards renders them as a card-style layout. The template runs on Jekyll and uses the github-pages gem, meaning it can be hosted for free on GitHub Pages. The project is authored by Elle Kasai and was designed with guidance from Shu Uesugi.

Key Features

• Markdown-based editing — Resume content is written in Markdown with YAML front matter fields for type, heading, subheading, duration, and location; optional fields can be removed.
• Mobile and desktop layouts — The generated resume is responsive and looks good on both screen sizes.
• PDF saving — The page is designed so users can save it as a PDF via the browser's print functionality.
• Color themes — Eight built-in color schemes (red, pink, brown, blue, purple, teal, green, and the default) are configurable through the color section of _data/resume.yml.
• Customizable metadata — Personal details like photo, name, and URL are set in _data/resume.yml, with a demo flag that hides extra navigation when set to false.
• Contact links and analytics — The _includes/nav.html file controls contact links, and _includes/script.html includes default Google Analytics code that can be changed or removed.
• Custom domain support — A CNAME file is included for hosting the resume on a custom domain.
• Jekyll/GitHub Pages workflow — Setup requires forking the repo, running bundle install to install the github-pages gem, and starting the server with jekyll serve --watch.

Who is it for?

• Job seekers who want a clean, code-controlled resume that can be updated by editing Markdown and deployed to GitHub Pages.
• Developers and designers comfortable with Jekyll who prefer to keep their resume in a Git repository and customize the theme via YAML.
• People needing a printable resume who want a layout that renders well when saved as a PDF from the browser.

What can you do with it?

• Create a personal resume page — Write your work history and education in _posts/card-[1-9].md and see it rendered as a styled card on a single page.
• Customize the visual theme — Change the color scheme by editing the color values in _data/resume.yml; eight swatches are provided.
• Deploy to GitHub Pages — Set baseurl and url in _config.yml, push the repo, and host the resume for free on GitHub Pages.

How does ResumeCards work?

After forking and cloning the repository, run bundle install to install the github-pages gem, then start the local server with jekyll serve --watch. Because the default baseurl is set to "/resumecards", the site initially runs at http://localhost:4000/resumecards/; change baseurl to "" in _config.yml to serve at the root. Editing resume content means modifying the Markdown files in _posts/ and updating personal data in _data/resume.yml; both changes take effect on page reload.

FAQ

Is ResumeCards still maintained?

No. The README states the project is no longer maintained; the author has other priorities and no longer has time to update the library.

What does ResumeCards require?

ResumeCards runs on Jekyll and requires the github-pages gem. You need Ruby and Bundler installed to run bundle install and start the local server with jekyll serve --watch.

Can I host ResumeCards on a custom domain?

Yes. A CNAME file is included in the repository. Change the CNAME contents to your domain and configure your DNS accordingly.

How do I change the color theme?

Edit the color section in _data/resume.yml. The README shows eight pre-built color options: red, pink, brown, blue, purple, teal, green, and the default.

Can I hide the demo navigation?

Yes. In _data/resume.yml, set demo to false to hide everything except the resume itself.