Charlie Macnamara - Technical Writer and Developer
  • About
  • Blog
  • Portfolio

Markdown CV Generator: Consistent designs matter

A markdown resume generator; for those also wronged by free trials.

After overhauling my site, I looked at my CV and thought, “This sucks.” Time to fix consistency.

Markdown CV Generator Example

I built a small tool: Markdown in, Tailwind styles, Node/Express with Puppeteer for crisp PDFs.

The Problem

Resume templates often disappoint. Paywalled builders are worse. This started after a £60 resume.io lapse.

The Solution

Markdown CV Generator. Write in Markdown, run a command, get a polished PDF.

  1. Write your CV in Markdown
  2. Run a command
  3. Get a professionally styled resume

Quickstart

Clone the repo:

bash
git clone https://github.com/CharlieMacnamara/Markdown-CV-Generator.git
cd Markdown-CV-Generator
npm install

Edit example.md, then run:

bash
markdowncv build --theme light

Done—your CV is ready.

Themes

1. Default Light Theme

  • Clean white, subtle shadows
  • Playfair headings, professional type
  • A4-ready
  • Clear separators

2. Dark Theme

  • Dark UI with balanced contrast
  • Blue accents that highlight key info
  • Auto light mode when printing
  • Modern typography

3. Soft Light Theme

  • Gentle palette with solid contrast
  • Elegant, readable type
  • Subtle shadows, rounded corners
  • Professional yet modern

Visual Features

Typography System

  • Playfair for hierarchy
  • Nunito Sans for body
  • Tuned spacing and tracking
  • Responsive sizing

Tailwind CSS Integration

  • Utility-first control
  • A4-safe responsive layout
  • Consistent styling across sections
  • Easy to customize

Cross-Platform Compatibility

  • macOS, Windows, Linux, WSL
  • Identical digital and print rendering
  • Consistent PDFs in modern browsers

What's Next?

Open source and yours to customize. New designs live in ./themes.

I’m shipping more themes and maybe a web interface. Suggestions welcome: repository.

© 2025 Charlie Macnamara. All rights reserved.

Built on: Next.jsReactTailwindCSSAWS