如何为VibeResume打造你自己的简历模板?HTML结构与字体体系完整开发指南
如何为VibeResume打造你自己的简历模板?HTML结构与字体体系完整开发指南
VibeResume 是一个 AI 友好、网页优先、可一键导出 PDF 的开源简历模板仓库。它把简历维护成 HTML + CSS 静态文件,让 AI 直接改内容和排版,再用 Chromium 脚本稳定导出 PDF。本文带你完整拆解它的模板目录、HTML 结构骨架和字体体系,教你从零打造属于自己的 VibeResume 简历模板。
为什么先看懂 HTML 结构
传统 Word / LaTeX 简历很难让 AI 编辑,浏览器打印 PDF 又经常分页错位。VibeResume 的思路是:网页即源文件、AI 即编辑器、PDF 即构建产物。想打造自己的模板,只需要动两类文件:
index.html—— 简历内容与模块结构styles.css—— 布局、字号、颜色、间距
仓库内置了三套现成模板,可以作为改造起点,总览见 templates/README.md:
| 模板 | 路径 | 适合场景 |
|---|---|---|
| 标准单页 | templates/internship-employment/standard-one-page/ | 经历较少、强调快速扫描 |
| 高密度双页 | templates/internship-employment/dense-two-page/ | 项目/实习/开源经历较多的技术岗 |
| 科研申请 | templates/research-application/research-classic/ | 博士申请、科研实习 |
三步看懂 HTML 结构骨架
以标准单页模板 index.html 为例,整个页面就 5 个核心区块,结构非常清晰:
1. 图标雪碧图(SVG symbol)
文件开头是一大组 <symbol> 图标定义(电话、邮箱、学校、公文包等),正文里用 <use href="#icon-school"> 引用。好处是所有图标内置在单个文件中,不依赖外部图标库,导出 PDF 时也永远不会加载失败。
2. 工具栏 .toolbar
包含打印按钮和来源链接,仅供网页预览使用。导出脚本会自动隐藏它,所以最终 PDF 里不会出现。
3. 页面容器 .page / .resume-page
这是导出逻辑的关键锚点:
- 单页模板:一个
<main class="page">,导出器会动态测量它的实际高度生成一页 PDF - 双页模板:多个
.resume-page,导出器按页切分。内容较少时删掉第二个.resume-page,同一导出器会自动生成一页 PDF
💡 记住这个规则:想让模板"能导出来",页面容器类名不能乱改。
4. 头部 .resume-header + 各模块 .section
头部放头像、姓名、联系方式;正文按"教育背景 → 实习经历 → 项目 → 技能"组织成多个 <section class="section">。每条经历是一个 <article class="experience">,内部固定为"公司/岗位/时间 + 一句话背景 + 要点列表"。新增或删减模块时,照这个粒度复制即可。
字体体系:让排版稳定的关键
字体是简历模板最容易被忽略、却最影响"高级感"的部分。仓库内置了本地字体文件,位于 assets/fonts/:
eb-garamond-regular.woff2/eb-garamond-semibold.woff2/eb-garamond-bold.woff2
高密度双页模板在 styles.css 中通过三段 @font-face 把这三个 woff2 文件声明为同一个字体族 EB Garamond Local,并按 400 / 600 / 700 三种字重挂载,font-display: swap 保证加载体验:
@font-face {
font-display: swap;
font-family: "EB Garamond Local";
font-weight: 700;
src: url("../../../assets/fonts/eb-garamond-bold.woff2") format("woff2");
}
两个模板的字体策略各有侧重:
- 双页技术模板:
"EB Garamond Local", "PingFang SC", "Helvetica Neue", sans-serif,衬线体负责英文/数字的优雅感,中文回落到苹方,参考尺度为 A3 竖版(1122 × 1588 CSS px),正文 12pt、章节标题 18pt - 标准单页模板:
"Noto Sans CJK SC", "Microsoft YaHei", "PingFang SC", ...(见 styles.css),纯无衬线、信息密度友好
这套"本地 woff2 + 系统字体兜底"的写法保证了导出 PDF 时的字体渲染在每台机器上都一致,不需要依赖在线字体服务。改造模板时,建议保留字体回退链,只调整字号与行高,这也是模板 README 中明确给出的密度调优建议(参见 dense-two-page/README.md 的"字体与密度"一节)。
动手打造你自己的模板
- 复制模板:把
templates/internship-employment/standard-one-page/整体复制一份,改名成你的模板名 - 改 CSS 变量:双页模板顶部
:root里集中定义了--page-width、--blue、--ink、--muted等变量,改颜色只需改这一处 - 替换头像与 Logo:头像放 assets/avatar.png,公司/项目 Logo 以 SVG 形式放 assets/logos/ 并在
index.html中本地引用(正式简历不热链 CDN) - 调整结构:按
.section/.experience粒度增删模块,保持容器类名.page或.resume-page不变 - 预览与导出:在仓库根目录执行以下命令验证效果
npm install
npm run preview
./export-pdf.sh export/my-resume.pdf templates/internship-employment/standard-one-page/index.html
浏览器只负责预览,最终 PDF 必须走官方导出脚本(export-pdf.sh / scripts/export-pdf.mjs)。导出器会强制使用 screen 布局渲染,并校验 PDF 文本层是否缺失,避免"只有背景没有文字"的静默失败。
进阶:让 AI 帮你改模板
仓库内置了 Codex-style 技能 skills/vibe-resume-editor/SKILL.md,其中写明了模板选择、页数控制、Logo 处理等编辑规范。安装后只需对 AI 说一句:
使用 vibe-resume-editor skill,把这份 Vibe 简历改成我的真实后端开发实习简历,并导出一页 PDF。
小结
为 VibeResume 打造自定义模板的完整路径可以概括为:
- 📁 在
templates/下复制并新建模板目录 - 🏗️ 保持
.page/.resume-page容器与.section模块结构不变 - 🔤 沿用"本地 woff2 + 系统字体回退"的字体体系,按需调字号
- 📄 用官方导出脚本验证 PDF,而不是浏览器打印
把网页当源文件、把 PDF 当构建产物——掌握这套 HTML 结构与字体体系,你就能让每一版简历都稳定、专业且可版本化管理。


