用一小段 front matter 开头
文档最前面可以用一个极简的 key: value 区块描述你是谁，夹在两行 --- 之间。没有 YAML 嵌套，没有插件，也就没有会坏掉的地方。
resume.md
---
name: 陈思远
title: 高级前端工程师
email: siyuan.chen@example.com
phone: +86 138 0000 1234
location: 上海
website: siyuan.dev
github: github.com/siyuanchen
linkedin: linkedin.com/in/siyuanchen
avatar:
---
只读取九个字段：name、title、email、phone、location、website、github、linkedin、avatar，全部可选。也可以完全跳过这段，直接用 # 你的姓名 开头，第一个一级标题会被当作姓名。
联系方式越普通越好 用你真正会查看的邮箱、带国家区号的手机号，以及一个作品集链接。招聘者会复制这些信息，多余的符号对双方都是负担。
二级标题分章节，三级标题分条目
两个标题层级撑起整份简历。## 开始一个章节，例如工作经历、技能；### 开始一段经历、项目或学历。条目标题内用 · 分隔职位与公司，用 | 分隔时间。
结构示例
## 工作经历
### 高级前端工程师 · 星澜科技 | 2021 — 至今
- 主导数据分析平台重构，服务 4 万+ 团队。
- 推动设计系统覆盖 120 个页面，零停机迁移。
### 前端工程师 · 北风工作室 | 2017 — 2021
- 负责年交易额 8000 万美元的商城结算流程。
这就是全部语法。三级标题之后的内容都属于该条目，因此「一段说明 + 若干项目符号」在版面上会自然成为一组。
写能扛住六秒扫读的项目符号
招聘经理很少逐字阅读简历，他们扫的是每条项目符号的左边缘，寻找动词和数字。把这两样东西放在最前面。
- 用动词开头：主导、交付、重构、降低、谈成。
- 先写结果再写工具：「把结算延迟降低 38%」比罗列框架更有说服力。
- 每条至少量化一个维度：用户量、收入、节省的时间、团队规模或百分比。
- 单条控制在 60 个汉字左右，最多两行。
- 只对最关键的三五个词使用 加粗。
一段经历写三条扎实的，胜过六条含糊的。如果一条内容在面试中无法展开，就删掉它。
一页、两页，还是介于两者之间
经验不足十年时，一页是默认选项；当每一行都有证据时，两页也完全合理。关键在篇幅由内容决定，而不是靠压缩版式硬塞。
- 一页中文简历大约 900–1300 字，英文约 350–550 词。
- 超出几行时先用「紧凑」密度，内容偏少时切到「舒适」。
- 先删最早一段经历里最不相关的条目，再考虑缩小字号。
- 让 A4 预览如实显示分页——打印时一条项目符号被拦腰截断就是缺陷。
五个常见排版错误
- 标题层级混乱：章节之外出现三级标题，会失去视觉归属。
- 用表格排版——ATS 解析表格时顺序经常错乱。
- 日期里混入表情或括号；保持
| 2021 — 至今这种可预测的写法。 - 把姓名做成图片，搜索和解析都无法识别。
- 粘贴原始 HTML。出于安全考虑，编辑器只保留
<br>，其余都会被移除。
格式本身就是价值 Markdown 简历可 diff、可版本化、可迁移。即使有一天你不再使用这个工具，内容依然是纯文本，而不是被锁在某个专有文档里。