md2resume · Markdown 简历生成
Markdown 转一页 DOCX 中文简历的 skill。主路径是参考模板克隆法：拿一份已排版的 docx 当骨架，复刻其配色、色块、字体层级与证件照，只替换文字；自动处理受限字体净化（bare Courier → Arial）、--scale 等比缩放压一页、每段最后一条要点渲染成成果蓝条。
无参考模板时走纯代码渲染法（免模板）。视觉对齐 professional 风格：深蓝标题、蓝色段落下划线、蓝色 bullet。
调用示例：在聊天框中说"把这份经历整理成一页简历，照参考模板的风格"。
产品详解
定位
md2resume 是 Markdown → 一页 DOCX 中文简历的专用渲染器：把结构化 Markdown 渲染成带设计感的投递级简历。它只做简历，不做通用 Word 编辑。
核心能力
- 路径 A：参考模板克隆法（主，高保真）：拿已排版的 docx 当骨架，克隆其段落样式（配色/字体/色块/证件照/页边距），只替换文字；样本骨架
assets/reference-template.docx可直接用，也可指定自己的模板。 - 自动三件套：受限字体净化（模板宏样式带出的 bare
Courier自动替换为可嵌入的 Arial，不误伤Courier New）、--scale等比缩放压一页（0.8–1.0）、成果蓝条（每段最后一条要点自动渲染为浅蓝底#EBF3FB+ 左蓝竖条#2E75B6+ 深蓝字）。 - 路径 B：纯代码渲染法（免模板）：
core/parser.py解析 →core/docx_renderer.py渲染；输入更自由（半角|、段落数不限）。 - 统一视觉系统：主蓝
#2E75B6/ 深蓝#1F4E79/ 正文#404040；中文微软雅黑 + 西文 Arial；深蓝标题、蓝色段落下划线、蓝色 bullet。 - 出图自检：Quick Look 缩略图或 LibreOffice 渲染检查一页、成果蓝条在位、加粗克制（每条最多 1-2 个关键词）。
工作流程
- 按路径约定整理 Markdown（路径 A：全角
｜分字段、一行联系方式、段落名固定为教育背景/实习经历/核心能力；路径 B：见 references/markdown-conventions.md） - 路径 A：
build_docx_from_reference.py … --reference <模板> --scale 0.99；路径 B：build_b_resume.py - 出图自检：① 一页 ② 成果蓝条在位 ③ 加粗克制
- 按需微调
--scale（溢出调小、留白多调大）
输入与输出
| 输入 | 说明 |
|---|---|
| 结构化 Markdown | 路径 A 用全角 ｜ 方言（# 姓名｜职位、### 公司｜部门·职位｜日期、**标题**），路径 B 更自由 |
| 参考模板 | 可选（路径 A）；模板里的证件照会原样保留 |
| 证件照 | 可选（路径 B 的 photo_path） |
输出：一页 DOCX 中文简历。
与相邻 skill 的区别
- docx（办公文档）：通用的 Word 创建/编辑/审阅工具；md2resume 是简历专用的固定模板渲染链路。
适用场景
- 把经历笔记、旧简历快速转成投递级简历
- 照某份参考简历的风格出一版新的
- 微调字号与间距，把内容压进一页
- 参考模板带受限字体（Courier），需净化后投递
使用前准备
- 无需 API key；Python 环境 + 仓库脚本（运行命令假设 cwd = 仓库根目录）。
- 路径 A 注意：参考模板的证件照会被原样保留进产出；用脱敏样本时正式投递前换回自己的模板或事后替换图片。
- 交付目录只保留 DOCX；页数 QA 的临时 PDF 渲染到
/tmp后删除。
md2resume 隶属于 Aiglade Skill 库。在 Aiglade 聊天框中用自然语言描述需求即可调用。