resume-pdf

Resume PDF Generator

Convert a Markdown resume into a professionally formatted PDF using customizable HTML templates.

When to use

The user has a structured Markdown resume and wants to generate a PDF file. The user may also want to:

• Choose between different template styles
• Preview the generated HTML before PDF output
• Customize the output path

Skill directory

This skill is self-contained. All resources (scripts, templates, examples) are located relative to this SKILL.md file:

resume-pdf/
├── SKILL.md              ← this file
├── scripts/md2pdf.mjs    ← conversion engine
├── scripts/package.json  ← dependencies (puppeteer-core)
├── templates/            ← HTML templates
├── examples/             ← example resume
└── references/           ← format documentation

Use the directory containing this SKILL.md as <skill-dir> in the commands below.

Prerequisites

Before running the conversion script, ensure dependencies are installed:

cd <skill-dir>/scripts && [ -d node_modules ] || npm install && cd -

The system must have Google Chrome or Chromium installed. The script auto-detects the browser path across macOS, Windows, and Linux.

How it works

Step 1: Confirm inputs

Ask the user for:

1. Resume file path (required) — Path to the Markdown resume file
2. Template (optional) — Which template to use:
   • <skill-dir>/templates/简历模板-标准专业版.html — Standard Professional (navy blue, centered header, formal) [default]
   • <skill-dir>/templates/简历模板-简洁商务版.html — Clean Business (modern, three-column work experience layout)
3. Output path (optional) — Where to save the PDF. Defaults to same directory as input file.

Step 2: Run the conversion

Execute the conversion script:

node <skill-dir>/scripts/md2pdf.mjs <resume.md> [--template <template.html>] [--output <output.pdf>]

Examples:

# Default template (auto-detected from script location)
node <skill-dir>/scripts/md2pdf.mjs my-resume.md

# Business template
node <skill-dir>/scripts/md2pdf.mjs my-resume.md --template <skill-dir>/templates/简历模板-简洁商务版.html

# Custom output path
node <skill-dir>/scripts/md2pdf.mjs my-resume.md --output ~/Desktop/resume.pdf

Step 3: Report results

The script outputs:

• A .html file (intermediate, for debugging/preview)
• A .pdf file (final output)

Tell the user both file paths and the key stats (skills count, jobs count, projects count) logged by the script.

Step 4: Handle errors

Common issues and fixes:

Error	Cause	Fix
Cannot find package 'puppeteer-core'	Dependencies not installed	Run npm install in <skill-dir>/scripts/
Chrome/Chromium not found	No browser installed	Install Chrome: brew install --cask google-chrome (macOS) / apt install google-chrome-stable (Linux)
Could not find expected browser	Puppeteer can't locate Chrome	Check Chrome installation path

Markdown resume format

The Markdown resume must follow this structure. See references/md-format.md for full details.

# Name

Contact info line (phone, email, GitHub)

## 技能清单
1. Skill item 1
2. Skill item 2

## 期望职位
Position City Salary

## 工作经历
### YYYY/MM - YYYY/MM Company Role
- Description bullet

## 项目经历
### YYYY/MM - YYYY/MM Project Name
技术选型：Tech stack
项目描述：Project description
责任描述：
- Responsibility bullet

## 教育背景
School / Major / Degree / Period

Important notes

• The script dynamically generates HTML entries for any number of jobs/projects — it is not limited by the template's placeholder count
• Both templates are print-ready with @media print and @page { size: A4 } CSS
• The HTML output can be opened in a browser for quick preview before committing to the PDF
• Section headings in the Markdown must use Chinese: 技能清单, 期望职位, 工作经历, 项目经历, 教育背景