code-a-cv voxvanhieu
Use this command to install code-a-cv with WinGet:
winget install --id=voxvanhieu.code-a-cv -e Build CVs from Markdown or structured data
Loading...
README
Code a CV
Still naming it like CV_ElonMusk_Facebook_final_v2.pdf? Just focus on your work experiences, mark it down, and let cac do the rest. That’s the idea behind CV as Code.
Write your CV as code and render it as PDF or HTML. Keep your content in version control, choose a theme, and rebuild consistently.
- Author in Markdown, or use JSON, YAML, and TOML.
- Import and export the supported JSON Resume subset.
- Check content and format source files without an LLM.
- Customize PDF layouts with reusable themes.
> ⭐ Your star can help make Code a CV better
Quick start
Install cac on macOS or Linux:
brew install voxvanhieu/tap/code-a-cv
Other installations
npm
With Node.js 24 or newer, install on macOS, Linux, or Windows:
npm install -g @voxvanhieu/code-a-cv@latest
Windows
Winget installation will be available in a future release. For now, download cac-x86_64-pc-windows-msvc.zip from the latest release, extract cac.exe, and add its directory to PATH.
Linux
The Homebrew command above also works on Linux. You can also build cac from source.
Install from source
Install Rust 1.92 or newer, then run:
git clone https://github.com/voxvanhieu/code-a-cv.git
cd code-a-cv
cargo install --path crates/cac --locked
Create a CV:
mkdir my-cv
cd my-cv
cac init
Edit the generated cv.md, then build your PDF:
cac build
Open offering/cv.pdf. This is your carefully prepared offering to the hiring gods.
Continue with the usage guide
for authoring, settings, and output options.
Write and maintain your CV
| Task | Command | Guide |
|---|---|---|
| Start or import a CV | cac init | Getting started |
| Check content | cac check cv.md | Content checks |
| Format the source in place | cac fmt | Formatting |
| Render PDF or HTML | cac build | Building and settings |
| Convert source formats | cac convert cv.md --to json | Conversion |
See FieldMark syntax for headings and optional fields, and example projects for complete CVs and rendered results.
Choose or create a theme
The classic theme is included. Follow using themes
to find, install, and select another design.
To create your own, use cac theme init, cac theme test, and cac theme pack.
The theme contribution guide explains the workflow;
the shared theme contract defines the
rendering requirements.
Development
See the development guide for setup, architecture, testing, pull requests, and releases.
Roadmap
- More themes
- Rebuild automatically when files change
- Create job-specific CV versions with tags
- Fit a CV to a page limit
- Check the rendered PDF for missing content
- WebAssembly support
- Stunning local Web UI with Tauri
- VS Code extension
License
Code a CV is available under the MIT License.