YAMLResume

Writing resumes may not be hard, but it is definitely not fun and tedious.

YAMLResume allows you to manage and version control your resumes using YAML and generate professional looking PDFs with beautiful typesetting in a breeze.

The Design Principle

This project was started as the core typesetting engine for PPResume, a LaTeX based, pixel perfect resume builder. After careful consideration, we decided to open source it so people can always have the right to say no to vendor lock-in.

The core design principle of YAMLResume is Separation of Concerns. One of the most famous examples that follows this principle is HTML & CSS, which are the foundation of the modern web—HTML is used for organization of webpage content, CSS is used for definition of content presentation style.

Following the core principle, YAMLResume is implemented by satisfying the following requirements:

• the resume content is drafted in plain text
• the plain text is structured using YAML—YAML is better than JSON because it is more human-readable and human-writable
• the YAML plain text is then rendered into a PDF with a pluggable typesetting engine
• the layout can be adjusted with options like font sizes, page margins, etc.

Quick Start

Install yamlresume:

# using npm
$ npm install -g yamlresume

# using yarn
$ yarn global add yamlresume

# using pnpm
$ pnpm add -g yamlresume

# using bun
$ bun add -g yamlresume

Verify yamlresume is installed successfully:

$ yamlresume help
Usage: yamlresume [options] [command]

YAMLResume — Resume as Code in YAML

 __   __ _    __  __ _     ____
 \ \ / // \  |  \/  | |   |  _ \ ___  ___ _   _ ___  ___   ___
  \ V // _ \ | |\/| | |   | |_) / _ \/ __| | | / _ \/ _ \ / _ \
   | |/ ___ \| |  | | |___|  _ <  __/\__ \ |_| | | | | | |  __/
   |_/_/   \_\_|  |_|_____|_| \_\___||___/\____|_| |_| |_|\___|


Options:
  -V, --version   output the version number
  -v, --verbose   verbose output
  -h, --help      display help for command

Commands:
  new [filename]  create a new resume
  build <source>  build a resume to LaTeX and PDF
  languages       i18n and l10n support
  templates       manage resume templates
  help [command]  display help for command

You need to install a typesetting engine, XeTeX or Tectonic in order to generate PDFs.

Besides, we recommend you to install Linux Libertine font in order to get the best looking PDFs.

Create a new resume

You can create your own resume by cloning one of our sample resumes here, so once you have the sample resume on your local, you can get a pdf with:

$ yamlresume new my-resume.yml
$ yamlresume build my-resume.yml

Check the generated PDF here.

PPResume Gallery provides a showcase for all possible kind of resumes categoried by languages and templates.

More samples would come soon!

Typesetting

YAMLResume adopts LaTeX as the default typesetting engine, which is the state of the art typesetting system in the academic and technical publishing industry.

Meanwhile, by following the resume typesetting best practices, YAMLResume always guarantees you Pixel Perfect resumes.

In the future we may support other typesetting engines like Typst, HTML/CSS, etc.

Contributing

Any kind of contributions will be deeply appreciated! Please read the contributing guidelines before submitting a pull request.

Star History

Roadmap

• support more font families
• section alias
• section reordering
• section cloning
• more resume templates
• more locale languages