RenderCV 简历即代码使用教程
RenderCV 是一个开源的简历即代码（CV-as-Code）工具，专为学术研究人员、工程师及需要长期维护高质量 CV 的人群设计。它将简历内容以纯 YAML 文本形式编写，通过 Typst 排版引擎一键生成专业 PDF，同时支持多种输出格式。
项目地址
- GitHub: https://github.com/rendercv/rendercv
- 官方文档: https://docs.rendercv.com/
- 在线体验（Beta）: https://rendercv.com/
一、核心理念
RenderCV 的设计哲学只有一句话：
内容与样式彻底分离 + 简历即代码
核心优势：
- 内容（个人信息、经历、论文等）只写在 YAML 文件中，使用 Markdown 描述，支持版本控制（Git）
- 样式（字体、颜色、间距、布局、主题）完全由配置文件控制，无需修改底层排版代码
- 支持自动化渲染、CI/CD 持续更新 PDF
- 内置严格的数据校验（Pydantic + JSON Schema），编辑器可智能提示
- 解决传统 LaTeX 简历的三大痛点：
- 修改一处就要手动重新编译
- 格式经常跑偏，需要反复微调间距
- 难以版本控制和多人协作
最适合的人群：
- 学术界（博士生、博后、教授）：频繁更新论文列表
- 工程师：经常跳槽、需要快速迭代简历
- 开源项目维护者：希望 CV 与 GitHub 联动
二、技术架构分层
用户输入 → YAML 文件 ↓ 数据解析与校验（ruamel.yaml + Pydantic） ↓ 数据模型（7种 Entry 类型） ↓ 模板填充（Jinja2 + Typst 模板） ↓ 渲染引擎（内置 Typst 编译器） ↓ 输出（PDF / LaTeX / Markdown / HTML / PNG）三、支持的 7 种核心条目类型（Entry）
| 条目类型 | 主要用途 | 典型字段示例 | 是否支持 Markdown |
|---|---|---|---|
| BulletEntry | 项目、技能、 bullet points | title, location, date, text | 是 |
| TextEntry | 个人简介、研究方向 | content | 是 |
| EducationEntry | 学历信息 | institution, degree, gpa, honors, date | 部分 |
| ExperienceEntry | 工作/实习经历 | company, position, location, date, description | 是 |
| NormalEntry | 奖项、证书、语言、专利等 | name, value, date | 是 |
| PublicationEntry | 学术论文（最强项） | title, authors, journal, year, doi, url | 否（结构化） |
| OneLineEntry | 单行信息（技能栈、工具等） | name, value | 否 |
四、快速上手（5 分钟入门）
1. 安装（推荐 Python 3.12+）
# 完整安装（包含 Typst 等依赖）pipinstall"rendercv[full]"# 或者使用 Docker（零环境依赖）dockerpull ghcr.io/rendercv/rendercv2. 创建模板
rendercv new"你的名字"# 示例：rendercv new "李明"会在当前目录生成李明_CV.yaml文件。
3. 编辑 YAML（强烈推荐 VS Code + YAML 插件）
cv:name:李明location:北京email:liming@example.comphone:"+86 138 xxxx 5678"website:https://liming.devsocial_networks:-network:GitHubusername:liming-github-network:ORCIDusername:0000-0003-1234-5678design:theme:Classiccolor:"#1E3A8A"font:"Noto Sans CJK SC"sections:教育背景:-type:EducationEntryinstitution:北京大学degree:计算机科学 博士date:2021.9--至今gpa:"3.89/4.0"location:北京工作经历:-type:ExperienceEntrycompany:某大厂 AI Labposition:高级算法工程师date:2019.7--2021.8location:北京description:|-• 主导千亿参数多模态模型预训练 • 训练效率提升 42%，节约约 1500 万 GPU 小时代表性论文:-type:PublicationEntrytitle:Improving Safety Alignment in Large Language Modelsauthors:李明,张伟,王芳 等year:2025journal:arXivdoi:10.48550/arXiv.2501.09876url:https://arxiv.org/abs/2501.098764. 一键渲染
rendercv render"李明_CV.yaml"输出目录rendercv_output/中会生成：
李明_CV.pdf（主文件）- Typst 源文件
- Markdown / HTML / LaTeX 源文件
- 逐页 PNG 预览
五、高级用法速览
- 切换主题
design:theme:EngineeringResumes# 或 Modern, Sleek 等color:"#111827"font:"Source Han Serif"- 论文列表独立管理
# publications.yamlpublications:-type:PublicationEntry...# 主文件 main.yamlsections:论文:!includepublications.yaml- GitHub Actions 自动部署最新版 CV
name:Render & Deploy CVon:[push]jobs:render:runs-on:ubuntu-lateststeps:-uses:actions/checkout@v4-name:Render CVuses:docker://ghcr.io/rendercv/rendercv:latestwith:args:render 李明_CV.yaml--output-folder public/-name:Deploy to GitHub Pagesuses:peaceiris/actions-gh-pages@v4with:github_token:${{secrets.GITHUB_TOKEN}}publish_dir:./public访问：https://你的用户名.github.io/李明_CV.pdf
六、谁最适合使用 RenderCV？（适用场景总结）
- 需要每年更新 5–30 篇论文的学术研究人员
- 平均1–2 年跳槽一次的工程师
- 希望 CV 与 GitHub 项目、论文列表保持实时同步的人
- 实验室/团队需要统一风格但内容个性化的场景
- 把简历当作长期数字资产来经营的人
一句话总结：
RenderCV 把写简历从“排版苦力活”变成了“写代码 + 享受自动化”的工程化体验。
现在就行动：
pipinstall"rendercv[full]"rendercv new"你的名字"祝你拥有一份永远保持最新、最美观的专业简历！
