YAMLResume

写简历不难，但反复调整格式、对齐、字体却令人疲惫。更麻烦的是，Word 或在线工具生成的简历难以版本管理，稍作修改就可能破坏整体布局。

YAMLResume 提供了一种更干净的解法：用 YAML 编写内容，用代码管理简历。它将简历拆解为结构化的数据文件，并通过可替换的排版引擎（默认为 LaTeX）生成像素级精准的 PDF，确保每次输出都一致、优雅、专业。

设计哲学：内容与样式分离

YAMLResume 的核心思想源于 Web 开发中的经典原则：HTML 负责结构，CSS 负责样式。

• YAML = 内容结构
  你的教育背景、工作经历、技能、项目等，全部以人类可读的 YAML 格式组织。比 JSON 更简洁，支持注释，适合手写。
• 排版引擎 = 样式呈现
  默认使用 LaTeX（推荐 XeTeX 或 Tectonic），遵循简历排版最佳实践。未来计划支持 Typst、HTML/CSS 等其他引擎。

这种分离带来三大优势：

1. 内容专注：你只写“是什么”，不操心“怎么排”。
2. 版本友好：YAML 是纯文本，可直接放入 Git，轻松追踪修改、协作或回滚。
3. 格式稳定：无 Word 的“格式漂移”，无在线工具的厂商锁定。

快速上手

安装

支持多种包管理器：

# npm
npm install -g yamlresume

# yarn
yarn global add yamlresume

# pnpm
pnpm add -g yamlresume

# bun
bun add -g yamlresume

注意：生成 PDF 需要 LaTeX 引擎（如 XeTeX 或 Tectonic）和字体支持（推荐安装 Linux Libertine 字体以获得最佳排版效果）。

若不想配置环境，也可通过 Docker 直接运行预打包镜像（详情见官方文档）。

创建并构建简历

# 生成新简历模板
yamlresume new my-resume.yml

# 构建 PDF（同时生成 .tex 和 .md）
yamlresume build my-resume.yml

输出包含：

• my-resume.pdf：最终简历
• my-resume.tex：LaTeX 源码（可进一步定制）
• my-resume.md：Markdown 版本（便于预览或发布）

开发模式（自动重构建）

yamlresume dev my-resume.yml

保存 YAML 文件后，PDF 会自动重新生成，适合边写边看。

可靠性保障：内置校验

YAMLResume 提供完整的 JSON Schema，支持：

• 字段类型校验（如日期格式、必填项）
• 结构合法性检查
• 错误提示定位

你可在构建前运行：

yamlresume validate my-resume.yml

提前发现拼写错误、缺失字段或格式问题，避免 LaTeX 编译失败。