resume-markdown 0.9.0

Convert Markdown resumes to HTML and PDF

resume.md

Write your resume in Markdown, style it with CSS, output to resume.html and resume.pdf.

Prerequisites

• Python ≥ 3.9 or uv
• Optional, required for PDF output: Google Chrome or Chromium

Installation

Note: This package is not yet published to PyPI. Install from GitHub using one of the methods below.

Using uvx (recommended, no installation needed)

Run directly without installing:

uvx --from git+https://github.com/mikepqr/resume-markdown resume-markdown

Using uv tool install (persistent installation)

Install once, use everywhere:

uv tool install git+https://github.com/mikepqr/resume-markdown
resume-markdown

Using pip

pip install git+https://github.com/mikepqr/resume-markdown
resume-markdown

Usage

Quick start

1. Create template files in your current directory:

   resume-markdown init
   # or with uvx: uvx --from git+https://github.com/mikepqr/resume-markdown resume-markdown init
   

   This creates resume.md and resume.css in the current directory.

2. Edit your copy of resume.md with your resume content (the placeholder text is taken with thanks from the JSON Resume Project)

3. Build HTML and PDF output:

   resume-markdown build
   # or with uvx: uvx --from git+https://github.com/mikepqr/resume-markdown resume-markdown build
   

Build options

• Use --no-html or --no-pdf to disable HTML or PDF output:

  resume-markdown build --no-pdf
  

• Use --chrome-path=/path/to/chrome if the tool cannot find your Chrome or Chromium executable (needed for PDF output)

  resume-markdown build --chrome-path=/path/to/chrome
  

• Specify a custom input file:

  resume-markdown build myresume.md
  

Customization

Edit resume.css to change the appearance of your resume. The default style is extremely generic, which is perhaps what you want in a resume, but CSS gives you a lot of flexibility. See, e.g. The Tech Resume Inside-Out for good advice about what a resume should look like (and what it should say).

Change the appearance of the PDF version (without affecting the HTML version) by adding rules under the @media print CSS selector.

Change the margins and paper size of the PDF version by editing the @page CSS rule.