This project allows you to write and maintain your resume in markdown. GitHub
Actions is used to generate stylized PDF and HTML files based on resume.md
and style.css. The stylized files are found as outputs in the Releases
section, the HTML file is also deployed as a static website using GitHub Pages.
This project is useful for anyone looking to create a professional-looking resume quickly and easily, and is especially beneficial for those with technical backgrounds who are familiar with markdown. With this project, you can focus on the content of your resume rather than worrying about formatting and deployment.
- Generate a new project using this repository as a template. Make sure to include all branches!
- Enable Read/Write Workflow permissions under
Settings->Actionsfor Pages deployment. - Edit the
resume.mdfile with your resume content using Markdown. - Commit and push the changes.
- Wait for the GitHub Actions to run. This will generate the PDF and HTML files and deploy the HTML file as a static website.
- Access the PDF and HTML in the
Releasessection. - Access your resume as a static website by going to
https://<your-github-username>.github.io/<repository-name>.
Resume-md uses nix to manage all dependencies and
to produce build outputs. As a result, any machine with nix installed can run
a simple build command to produce the stylized resumes.
nix buildThis will place the stylized files along side the original markdown file in
result/resume/:
ο result
βββ ο resume
βββ ο» resume.html
βββ ξ resume.md
βββ ο resume.pdfGitHub Pages is used to deploy the stylized HTML file as a static site. For this to work,
the Workflow Permissions MUST be set to read/write and the repository must be public or
the user a pro user. If you forked this repository or didn't copy the branches during generation,
you will need to point the pages deployment to the gh-pages branch under the Pages settings.
You can customize the stylized PDF and HTML output by editing style.css.
Originally inspired by vidluther's project.