# YAMLResume

YAMLResume is a command-line tool that lets users write resumes in YAML, version them with Git, and generate pixel-perfect PDF, HTML, Markdown, and DOCX files.

Canonical page: https://ourlocalhost.com/app/8027/yamlresume

## Description

YAMLResume is a command-line tool that lets users write resumes in YAML, version them with Git, and generate pixel-perfect PDF, HTML, Markdown, and DOCX files.

## Platform availability

Available on 1 of 10 platforms: Any server.

## Health score

77/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 4 days ago)
- Popular: 64 (1,563 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)
- Security check: 100 (no serious findings, CI, tests)

## Links

- Official website: https://yamlresume.dev
- GitHub: https://github.com/yamlresume/yamlresume
- Documentation: https://yamlresume.dev/docs

## Common questions

### Can I run YAMLResume in Docker without manually installing its typesetting dependencies?

Yes. The Docker image includes the CLI plus dependencies such as XeTeX and some recommended fonts. Mount your local directory to /home/yamlresume and run the new or build command in the container.

### How can I check my resume file for schema or field errors before building?

Run yamlresume validate on the YAML file. It reports schema validation issues, such as invalid email or URL values.

### How should I back up or track changes to a YAML resume?

Store the resume file in Git. Each edit can be committed, diffed, branched, and reverted like code.

### Can PDF builds be automated in CI/CD?

Yes. YAMLResume offers a GitHub Action for automated PDF builds in CI/CD workflows.

## Alternatives

- Jade
- Moderncv
- Mystmd
- Quarto-cli
- Resume-schema
- Typst

---
Source: Our Local Host (https://ourlocalhost.com/app/8027/yamlresume), the self-hosted and open-source app directory.
