Markdown CV Generator: Consistent designs matter
A markdown resume generator; for those also wronged by free trials.
'use client'
After the recent overhaul of my website, I found myself staring at my CV thinking, "This sucks, eh." Let's ensure consistency.
So I built this little tool. It combines the simplicity of Markdown (parsed with markdown-it) with the power of Tailwind CSS for styling. Under the hood, it's running on Node.js and Express, with Puppeteer handling the high-quality PDF generation. Simple yet powerful.
The Problem
Resumes are one of those things; always worth improving. Unfortunately, Google Docs template designs fall short. You've probably looked for a replacement. Typically though, you have to fork you for those—no need. The goal is getting a job.
Quick story: this project - born from a £60 resume.io fail. Forgot to cancel the trial, six months later? Not bad motivation.
The Solution
Enter Markdown CV Generator - a simple tool to build your CV. Here's how it works:
- Write your CV in Markdown
- Run a command
- Get a professionally styled resume
Quickstart
Getting started is straightforward. First, clone the repo:
git clone https://github.com/CharlieMacnamara/Markdown-CV-Generator.git
cd Markdown-CV-Generator
npm install
Then, edit the example.md file and run:
markdowncv build --theme light
That's it! Your CV will be generated.
Themes
1. Default Light Theme
- Clean white background with subtle shadows
- Professional typography using Playfair Display for headings
- Optimized A4 formatting for perfect printing
- Enhanced sectioning with subtle separators
2. Dark Theme
- Rich dark backgrounds with precisely calibrated text contrast
- Strategic blue accent colors that highlight key information
- Smart print adaptation that automatically converts to light theme when printed
- Modern typography optimized for digital reading
3. Soft Light Theme
- Gentle color palette with balanced contrast
- Elegant typography that enhances readability
- Subtle shadows and rounded corners for contemporary appeal
- Perfect balance between professionalism and modern design
Visual Features
Typography System
- Serif fonts (Playfair Display) establish clear visual hierarchy
- Modern sans-serif fonts (Nunito Sans) enhance body text readability
- Optimized line spacing and letter tracking create professional polish
- Responsive typography maintains readability across all devices
Tailwind CSS Integration
- Utility-first precise design control
- Responsive layout guarantees proper A4 sizing
- Unified styling ensures consistency across sections
- Flexible customization
Cross-Platform Compatibility
- macOS, Windows, Linux, and WSL environments
- Digital and print formats with identical rendering
- All modern browsers with consistent PDF generation
What's Next?
This project is open source. Feel free to customize it to your needs. New designs live in ./themes.
I'm planning to add more themes and a web interface. If you have any suggestions or want to contribute, the repository is available here.