如何为VibeResume打造你自己的简历模板?HTML结构与字体体系完整开发指南

原创2026-11-01 21:53:241,651 阅读

如何为VibeResume打造你自己的简历模板?HTML结构与字体体系完整开发指南

VibeResume 是一个 AI 友好、网页优先、可一键导出 PDF 的开源简历模板仓库。它把简历维护成 HTML + CSS 静态文件,让 AI 直接改内容和排版,再用 Chromium 脚本稳定导出 PDF。本文带你完整拆解它的模板目录、HTML 结构骨架和字体体系,教你从零打造属于自己的 VibeResume 简历模板。

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/ 博士申请、科研实习

VibeResume 标准单页简历模板效果预览

三步看懂 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">,内部固定为"公司/岗位/时间 + 一句话背景 + 要点列表"。新增或删减模块时,照这个粒度复制即可。

VibeResume 双页模板第一页版式细节预览

字体体系:让排版稳定的关键

字体是简历模板最容易被忽略、却最影响"高级感"的部分。仓库内置了本地字体文件,位于 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 的"字体与密度"一节)。

动手打造你自己的模板

  1. 复制模板:把 templates/internship-employment/standard-one-page/ 整体复制一份,改名成你的模板名
  2. 改 CSS 变量:双页模板顶部 :root 里集中定义了 --page-width、--blue、--ink、--muted 等变量,改颜色只需改这一处
  3. 替换头像与 Logo:头像放 assets/avatar.png,公司/项目 Logo 以 SVG 形式放 assets/logos/ 并在 index.html 中本地引用(正式简历不热链 CDN)
  4. 调整结构:按 .section / .experience 粒度增删模块,保持容器类名 .page 或 .resume-page 不变
  5. 预览与导出:在仓库根目录执行以下命令验证效果
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 结构与字体体系,你就能让每一版简历都稳定、专业且可版本化管理。

登录后查看全文
vibe-resume