Markdown 简历 — 从编写到导出 PDF 的完整指南
为什么要用 Markdown 写简历
如果你是程序员或者经常和技术文档打交道的人，用 Markdown 写简历可能是最自然的选择——不需要打开 Word 调格式，不需要在排版上花时间，打开文本编辑器就能开始。
Markdown 简历有几个明显的优势：
- 纯文本管理：简历就是一个
.md文件，用 Git 管理版本，随时回溯修改历史 - 关注内容而非排版：标题、列表、加粗这些格式由语法自动处理，你只需要想清楚写什么
- 跨平台兼容：同一份文件在 Windows、macOS、Linux 上完全一致，不会出现"换了台电脑排版全乱"的问题
- ATS 友好：大多数 ATS（Applicant Tracking System，简历筛选系统）对结构化的纯文本内容解析效果最好
对了，如果你还不熟悉 Markdown 的基本语法，可以先看看 Markdown 标题语法 和 Markdown 列表语法，这篇教程会直接上手写简历。
Markdown 简历的基本结构
一份标准的 Markdown 简历通常包含这几个板块，用 ## 作为板块分隔：
# 张三
北京 | zhangsan@email.com | 138-0000-0000 | [GitHub](https://github.com/zhangsan) | [LinkedIn](https://linkedin.com/in/zhangsan)
## 个人简介
5 年经验的全栈工程师，专注于 React 和 Node.js 技术栈...
## 工作经验
### 高级前端工程师 — ABC 科技有限公司
*2022.03 - 至今 | 北京*
- 主导公司核心产品的前端架构重构，页面加载速度提升 40%
- 搭建前端组件库，覆盖 30+ 业务组件，团队开发效率提升 25%
- 技术栈：React、TypeScript、Next.js、Tailwind CSS
## 教育背景
### 计算机科学与技术 — 北京大学
*2015.09 - 2019.06 | 硕士*
## 技能
- **编程语言**：JavaScript、TypeScript、Python、Go
- **前端框架**：React、Vue.js、Next.js
- **后端技术**：Node.js、Express、PostgreSQL、Redis
- **工具平台**：Git、Docker、AWS、CI/CD结构很清晰：姓名和联系方式在最顶部，然后按个人简介 → 工作经验 → 教育背景 → 技能的顺序排列。这个顺序不是随便定的——ATS 系统通常按从上到下的顺序解析，把最核心的工作经验放在前面能让系统更快地匹配到关键词。
完整的 Markdown 简历模板
下面是一个可以直接复制使用的完整模板，我根据技术岗位的特点做了调整：
# 你的姓名
城市 | email@example.com | 电话号码 | [GitHub](https://github.com/yourname) | [个人网站](https://yoursite.com)
## 个人简介
3 年经验的后端工程师，擅长分布式系统设计和高并发场景优化。在电商和社交领域有丰富经验，主导过日活百万级系统的架构设计。
## 工作经验
### 职位名称 — 公司名称
*起始时间 - 结束时间 | 工作地点*
- 用"动词 + 做了什么 + 结果"的方式描述每条经验
- 设计并实现了订单系统的微服务拆分，系统吞吐量提升 3 倍
- 搭建了完善的监控告警体系，故障平均响应时间从 2 小时缩短到 15 分钟
- 技术栈：Go、gRPC、Kubernetes、MySQL、Redis
### 之前的职位 — 之前的公司
*起始时间 - 结束时间 | 工作地点*
- 负责核心 API 网关的设计与开发，日均处理请求 500 万+
- 优化了数据库查询性能，慢查询数量减少 80%
- 技术栈：Java、Spring Boot、MongoDB
## 项目经验
### 开源项目名称
*项目链接*
一句话描述这个项目解决了什么问题。
- 核心功能和亮点
- GitHub Star 数或用户量等数据
## 技能
- **编程语言**：Go、Java、Python
- **框架**：Gin、Spring Boot、Django
- **数据库**：MySQL、PostgreSQL、Redis、MongoDB
- **工具**：Docker、Kubernetes、Prometheus、Git
## 教育背景
### 专业名称 — 学校名称
*起始时间 - 结束时间 | 学位*
## 证书（可选）
- AWS Solutions Architect Professional — 2024
- Kubernetes Administrator (CKA) — 2023说实话，这个模板看上去很朴素，但朴素正是 Markdown 简历的优势。ATS 系统不喜欢花哨的排版，单栏、结构化、纯文本的内容对机器解析最友好。
简历中的 Markdown 语法要点
写简历时最常用的语法不多，但有几个细节值得注意：
加粗用两个星号包裹关键词，比如职位名称和技能类别。在简历里适度使用 Markdown 加粗语法 可以让招聘方快速扫到重点，但别滥用——整页加粗等于没加粗。
链接用来放 GitHub、个人网站、项目地址。用 Markdown 链接语法 的标准格式 [显示文本](URL) 就行，ATS 能识别出链接中的 URL。
列表是简历的主力语法。每条工作经历下的成就用无序列表 - 来展示，每条控制在 1-2 行。Markdown 列表语法 支持嵌套，但简历里一般用不到多层嵌套——保持扁平化更利于阅读。
分割线可以在联系方式和正文之间加一条 ---，视觉上做一下分隔。详情参考 Markdown 分割线语法。
怎么把 Markdown 简历导出为 PDF
Markdown 写完之后，最终要导出成 PDF 才能投递。有几种方式可以选择，各有各的特点。
方法一：在线工具（最快上手）
如果你想快速搞定，在线工具是最简单的选择：
MarkdownResume.app — 打开网站直接粘贴 Markdown 内容，选个模板就能导出 PDF。支持实时预览，操作非常直观。
Resumey.Pro — 提供 10 个 ATS 优化的模板，可以一键切换模板风格。免费版可以编辑，导出 PDF 需要付费。
Oh My CV — 开源的在线 Markdown 简历编辑器，界面干净，支持多种导出格式。
在线工具的优势是零配置、开箱即用。缺点是模板样式受限于平台提供的选项，自定义空间有限。
方法二：Typora 编辑器（所见即所得）
Typora 是我平时用得最多的 Markdown 编辑器之一，它的简历导出流程很流畅：
- 在 Typora 中写好简历
.md文件 - 点击菜单 文件 → 导出 → PDF
- 在弹出的打印对话框中调整页面设置（建议纸张选 A4，页边距适当缩小）
Typora 的导出质量很好，特别是对中文的字体渲染。我之前用 Typora 导出过一份中英混排的简历，效果比用在线工具导出的要好看不少——字体更清晰，列表缩进也更规范。
方法三：Pandoc 命令行工具（最灵活）
如果你对命令行不陌生，Pandoc 是最强大的选择：
# 基本导出
pandoc resume.md -o resume.pdf
# 指定 PDF 引擎和自定义 CSS
pandoc resume.md -f markdown -t pdf \
--pdf-engine=wkhtmltopdf \
-c resume-style.css \
-s -o resume.pdf
# 导出为 HTML（再用浏览器打印为 PDF）
pandoc resume.md -f markdown -t html \
-c resume-style.css \
-s -o resume.htmlPandoc 需要安装额外的依赖（LaTeX 或 wkhtmltopdf），配置稍微麻烦，但好处是可以通过 CSS 完全控制输出样式，还可以集成到自动化工作流中。
对了，如果你用的是 VS Code，也可以安装 "Markdown PDF" 扩展，在编辑器里直接导出。不过说实话，这个扩展的中文支持偶尔会有问题，导出前最好检查一下。
导出方式的对比
| 方式 | 难度 | 自定义程度 | 中文支持 | 适合人群 |
|---|---|---|---|---|
| 在线工具 | 低 | 中 | 取决于平台 | 快速上手，不想装软件 |
| Typora | 低 | 中 | 好 | 喜欢所见即所得 |
| Pandoc | 中 | 高 | 需要配置 | 熟悉命令行，追求完全控制 |
| VS Code 扩展 | 低 | 中 | 偶有问题 | 已经在用 VS Code |
Markdown 简历的 ATS 优化
ATS 是现在求职绕不开的话题。超过 98% 的大公司在使用某种形式的 ATS 来筛选简历，所以不管你简历写得多好，如果 ATS 读不懂，招聘方根本看不到。
为什么 Markdown 简历对 ATS 友好
ATS 系统解析简历的原理基本是：把文档内容提取成纯文本，然后按字段（姓名、联系方式、工作经历、技能等）进行分类。Markdown 简历天然就是结构化的纯文本——标题层级、列表、段落，这些信息帮助 ATS 更准确地识别各个板块。
MarkdownResume.app 做过一个测试：同样的简历内容，用单栏 Markdown 格式导出的 PDF，ATS 解析准确率比双栏 Word 格式高出约 30%。原因是双栏布局在 PDF 中会被 ATS 按行解析，导致左右两栏的内容混在一起。
ATS 优化清单
- 用标准板块名称：工作经验、教育背景、技能这些名字别整花活，ATS 按关键词匹配板块
- 日期格式统一：全程用
2022.03 - 2024.06或2022-03 至 2024-06，别混用 - 避免表格和复杂排版：Markdown 本身就没有复杂排版，这反而成了优势
- 关键词覆盖：仔细看 JD（职位描述），把其中的技术关键词自然地写进简历
- 联系方式放在顶部：姓名下方紧跟电话、邮箱、城市
有一次我帮朋友检查简历，他用了一份非常漂亮的双栏 Word 简历，但在一个免费的 ATS 模拟测试工具里跑了一下，发现"技能"板块的内容完全没被识别出来——因为 ATS 把左右两栏的文字混在一起解析了。后来换成单栏 Markdown 格式重新排版，同样的内容，解析准确率一下子上来了。
中英文 Markdown 简历的差异
如果你的目标公司是外企或者需要投英文简历，有些细节值得注意：
英文名称：板块用 Summary、Experience、Education、Skills 这些标准英文名
英文名称示例：
# SAN ZHANG
Beijing, China | zhangsan@email.com | +86 138-0000-0000 | [GitHub](https://github.com/zhangsan)
## Summary
Full-stack engineer with 5 years of experience specializing in React and Node.js...
## Experience
### Senior Frontend Engineer — ABC Tech Co., Ltd.
*Mar 2022 - Present | Beijing*
- Led the frontend architecture refactoring of the core product, improving page load speed by 40%
- Built a component library covering 30+ business components, increasing team development efficiency by 25%
- Tech Stack: React, TypeScript, Next.js, Tailwind CSS
## Education
### M.S. Computer Science — Peking University
*Sep 2015 - Jun 2019*
## Skills
- **Languages**: JavaScript, TypeScript, Python, Go
- **Frontend**: React, Vue.js, Next.js
- **Backend**: Node.js, Express, PostgreSQL, Redis
- **Tools**: Git, Docker, AWS, CI/CD字体问题：中英混排时，PDF 渲染引擎可能对中文字体支持不好。如果遇到中文乱码或显示异常，建议在 CSS 中显式指定中文字体，比如 font-family: "Source Han Sans", "Microsoft YaHei", sans-serif;。
日期格式：中文简历用 2022.03 - 至今，英文简历用 Mar 2022 - Present。
推荐的 Markdown 简历工具
在线编辑器
- MarkdownResume.app：专注 Markdown 简历的在线编辑器，内置模板，免费导出 PDF。特点是模板都经过 ATS 优化，单栏设计
- Resumey.Pro：提供 10 个 ATS 优化模板，支持一键切换模板。免费编辑，付费导出
- Oh My CV：开源在线编辑器，支持 Markdown 实时预览和多种导出格式
本地工具
- Typora：所见即所得的 Markdown 编辑器，导出 PDF 质量高，中文支持好
- VS Code + Markdown PDF 扩展：如果你已经在用 VS Code，装个扩展就能直接导出
命令行工具
- Pandoc：万能文档转换工具，配合 CSS 可以完全控制输出样式。适合把简历导出流程集成到自动化工作流中
- wkhtmltopdf：Pandoc 导出 PDF 时的可选引擎，基于 WebKit 渲染，对 CSS 的支持比 LaTeX 更好
开源模板
- junian/markdown-resume：GitHub 上 559+ Star 的开源项目，提供 CareerCup 风格的简历模板，支持 PDF 和 DOCX 导出
- mszep/pandoc-resume：经典的 Pandoc 简历模板，适合命令行用户
常见问题
Markdown 简历能不能通过 ATS？
能，而且比大多数 Word 简历效果更好。原因前面说了——Markdown 的结构化内容让 ATS 能准确识别各个板块。关键是保持单栏布局、标准板块名称、统一日期格式。
Markdown 简历是不是只适合程序员？
不是。Markdown 简历适合任何想要简洁、结构化简历的人。不过 Markdown 语法确实对技术人员更友好，非技术背景的人可能需要花点时间熟悉语法，或者用在线编辑器来降低门槛。
导出的 PDF 看起来太朴素怎么办？
朴素不等于差。很多招聘方（特别是技术团队）反而更欣赏简洁的简历格式。如果确实需要更精致的外观，可以：
- 使用带样式模板的在线工具（如 Resumey.Pro）
- 通过 Pandoc 加载自定义 CSS
- 导出 HTML 后手动微调样式
简历应该写几页？
初、中级岗位建议控制在 1 页。资深岗位或学术简历可以 2 页。ATS 系统对页面数量没有特别偏好，但招聘方通常更喜欢精炼的简历。
参考来源
- CommonMark Specification — Markdown 语法的标准规范
- GitHub Flavored Markdown Spec — GitHub 扩展的 Markdown 语法规范
- Pandoc User's Guide — Pandoc 文档转换工具的官方文档
- JSON Resume Schema — 简历结构化数据的标准规范
- CareerCup Resume Template — 被广泛引用的简历格式参考