RenderCV简历即代码

🎯 【一句话洞察】

• RenderCV 是目前「简历即代码」赛道的最优解——用 YAML 写内容、Typst 渲染排版，把简历从文档变成可版本控制的代码工程，17k+ Star 验证了工程师群体对这件事的真实需求。

️ 【核心逻辑链】

1. 真问题是什么。 传统简历工具（Word、Canva、Notion）的本质是文档编辑器，排版和内容耦合，每次改内容都可能破坏格式，更别提版本管理。工程师的简历本质上是一组结构化数据（教育、经历、技能），用文档工具管理是在用错误的抽象层。

1. 为什么是 YAML + Typst。 YAML 天然适合结构化数据（列表、键值对、嵌套），Typst 是比 LaTeX 快 10 倍的现代排版引擎。两者组合 = 内容只写一次，排版由模板决定，永远不会出现"格式错乱"。

1. 主题切换的杀手体验。 内容不变，改 YAML 里 theme: classic 为 theme: ink，瞬间换一套排版风格。9 个内置主题覆盖学术 CV、工程简历、极简风等场景，这是 Word 永远做不到的。

1. 自定义模板是天花板。 rendercv create-theme mytheme 生成完整 Typst 模板，你可以改任何排版逻辑——分隔线、色块、字体、间距。从"用别人的主题"到"做自己的主题"，学习曲线平滑。

1. 中文适配。 语言设为 mandarin_chinese 即可正确渲染中文，包括日期格式、页脚文字等。字体需手动指定中文字体（如思源宋体）。

🏗️ 【技术架构】

• 输入格式: YAML（内容层） + JSON Schema（校验 + IDE 补全）
• 渲染引擎: Typst（现代排版，替代 LaTeX）
• 输出格式: PDF / PNG / HTML / Markdown / Typst 源码
• 分发方式: PyPI（pip install rendercv）+ Typst Universe 包
• 主题系统: Jinja2 模板引擎渲染 Typst 代码

⚙️ 【上手实践要点】

• 安装：pip install "rendercv[full]"（必须带 full，否则没有 Typst 渲染引擎）
• 生成示例：rendercv new "你的名字" → 得到示例 YAML
• 渲染：rendercv render 你的名字_CV.yaml → 同时出 PDF + PNG + HTML + MD + Typst
• Windows 中文环境需加 PYTHONIOENCODING=utf-8 避免编码崩溃
• 自定义主题：rendercv create-theme 主题名（名字只能用小写字母和数字）
• 关键文件：Preamble.j2.typ（全局配置注入）、Header.j2.typ（页头）、SectionBeginning.j2.typ（章节样式）、entries/NormalEntry.j2.typ（条目排版）

【相关扩展】

• Typst 排版系统本身值得关注——可能是 LaTeX 的真正替代者
• 「简历即代码」理念可延伸到其他文档场景（论文、报告、提案）
• 社区主题：rendercv4leaders（领导者风格主题）

️ 工具状态：活跃维护，2026-03 更新 Typst Universe 包 v0.3.0，PyPI 累计下载 140k+