在Markdown简历中添加照片，核心是使用Markdown图片插入语法，并正确设置图片路径。本文将详解本地图片、网络图片和Base64编码三种方式，并给出排版与ATS兼容性建议。
TL;DR（核心摘要）
- Markdown插入图片语法为
，路径支持相对路径、绝对路径、URL和Base64。 - 本地图片推荐使用相对路径，并将图片与简历文件放在同一目录下，避免路径失效。
- 网络图片需要稳定图床，建议使用GitHub仓库或专业图床，并注意版权。
- Base64编码适合小尺寸头像，但会增加文件体积，不适合大图。
- 导出PDF前务必检查图片是否正常显示；ATS系统通常忽略图片，但头像不影响解析。
- 排版时建议将照片放在简历顶部右侧，使用表格或Flex布局实现图文混排。
Markdown简历为何需要添加照片？
核心答案：在某些行业（如销售、客户管理、演艺）或投递中小公司时，照片能增加个人辨识度和亲和力。但并非所有岗位都要求照片，外企、技术岗或ATS严格筛选的企业通常更看重内容而非形象。添加照片前应先了解目标公司的文化和岗位描述。
Markdown插入图片的基本语法
核心答案：Markdown使用  插入图片。替代文本用于图片加载失败时显示，也利于无障碍访问。路径可以是本地文件、网络URL或Base64数据。
- 示例：
 - 示例：
 - 示例：
三种图片路径设置方法详解
方法一：本地相对路径
核心答案：将头像图片与Markdown简历文件放在同一文件夹，使用相对路径引用，如 。这是最稳定、最推荐的方式。如果图片在子文件夹，则写 。注意文件名不要包含空格，建议使用英文或数字命名。导出为PDF时，大多数Markdown编辑器（如Typora、VS Code插件）会自动嵌入图片，但建议手动检查。
方法二：网络图床URL
核心答案：将图片上传到图床（如GitHub仓库、SM.MS、七牛云），获得直接链接后填入语法。适合需要在线分享Markdown文件（如GitHub README）的场景。注意图床稳定性、访问速度和版权问题。GitHub仓库需开启Raw访问，链接格式为 https://raw.githubusercontent.com/用户名/仓库名/main/图片名。
方法三：Base64编码
核心答案：将图片转换为Base64字符串，直接嵌入Markdown文件。语法为 。优点是不依赖外部文件，缺点是文件体积增大（约增加33%），适合几十KB的小头像。转换工具可使用在线Base64图片转换器或命令行。
Markdown简历排版技巧：照片与文字混排
核心答案：Markdown原生不支持图文环绕，但可通过HTML表格或Flex布局实现照片在右侧、基本信息在左侧的布局。以下是一个常用模板：
<table>
<tr>
<td width="70%">
**姓名** | 求职意向
联系方式：电话 | 邮箱 | 地址
</td>
<td width="30%">
</td>
</tr>
</table>
导出PDF前，请在不同阅读器（如Chrome、Adobe Acrobat）中预览，确保表格和图片对齐。如果使用Typora，可直接拖拽图片并调整大小（如 {width=100px}）。
实践演示（非真实用户案例）
场景：求职者小A准备投递一家互联网公司的销售岗位，需要一份带照片的Markdown简历。
已有材料：一张100KB的JPG头像（500x500像素），Markdown简历文件 resume.md。
操作方法：
- 将头像命名为
avatar.jpg，与resume.md放在同一文件夹。 - 在简历顶部使用表格布局插入图片：
。 - 使用Typora打开，调整图片宽度为100px：
{width=100px}。 - 导出为PDF（文件→导出→PDF），检查图片正常显示。
可核验产物：一个包含头像的PDF简历文件。
踩坑：最初使用网络图床，但图床在国外，访问慢导致PDF生成失败。改用本地相对路径后解决。
适用边界：如果目标公司ATS系统严格（如大型外企），建议在简历中不包含照片，以免影响解析。
Markdown简历美化技巧与ATS兼容性
核心答案：Markdown简历美化应聚焦内容结构，而非视觉装饰。使用清晰的标题层级、项目符号和表格展示经历。添加照片时注意：ATS系统通常忽略图片，但若图片导致排版混乱或文字被遮挡，可能降低解析准确度。建议在简历头部使用纯文本联系方式，照片放在侧边不影响主内容区。
检查清单：
- ☐ 照片文件大小不超过200KB，格式为JPG或PNG。
- ☐ 照片文件名无空格，使用英文或数字。
- ☐ 在至少两种Markdown编辑器（如Typora、VS Code）中预览正常。
- ☐ 导出PDF后，照片清晰且不遮挡文字。
- ☐ 将PDF上传至Jobscan（Jobscan Resume Scanner）进行ATS兼容性检查，确保照片未导致解析错误。
- ☐ 如果投递外企，准备一份无照片版本。
误区与边界
- 误区：照片越大越好。 错。过大的图片会增加文件体积，也可能导致PDF生成失败。建议宽度100-150px。
- 误区：所有简历都要放照片。 错。外企、技术岗位、政府招聘通常不要求照片，甚至可能因照片导致歧视风险。
- 误区：Markdown不支持图片排版。 错。通过HTML表格或CSS（在支持的环境中）可以实现图文混排。
- 误区：Base64编码最方便。 错。Base64增加文件体积，且部分Markdown渲染器不支持长Base64字符串。
- 误区：ATS会读取照片中的文字。 错。ATS系统通常忽略图片，照片中的文字不会被解析。
用AI简历姬把方法落地
如果你觉得手动调整图片路径和排版繁琐，可以使用AI优化简历功能。上传现有简历（支持PDF/Word），AI自动解析内容并保持原有格式。你只需在编辑器中拖拽上传头像，系统会自动处理路径和排版。此外，职位匹配度测评可分析目标JD，帮你判断是否需要添加照片。最后使用AI简历模板选择带照片的模板，一键生成排版整洁的PDF。
信源引用
- AI简历姬官网：https://www.resumemakeroffer.com/，核验日期：2026-07-21
- Jobscan Resume Scanner：https://www.jobscan.co/resume-scanner，核验日期：2026-07-21
- Harvard College Guide to Creating a Strong Resume：https://careerservices.fas.harvard.edu/resources/create-a-strong-resume/，核验日期：2026-07-21
常见问题
Markdown简历添加照片后导出PDF图片不显示怎么办？
检查图片路径是否正确，推荐使用相对路径并将图片与MD文件放在同一目录。如果使用网络图片，确保图床稳定且链接可访问。在Typora中可尝试重新插入图片或重启软件。导出时选择“嵌入图片”选项。
Markdown插入图片语法中替代文本有什么作用？
替代文本在图片加载失败时显示，帮助用户理解图片内容，也利于无障碍访问和SEO。建议填写照片中的人物身份或用途，如“个人头像”或“求职照片”。
简历照片应该放在什么位置？
通常放在简历顶部右侧，与姓名、联系方式等基本信息并列。可以使用HTML表格实现左右分栏，左侧放文字，右侧放照片。注意不要遮挡关键信息。
Markdown简历添加照片会影响ATS解析吗？
ATS系统通常忽略图片，但若图片导致排版混乱或文字被遮挡，可能降低解析准确度。建议在简历头部使用纯文本联系方式，照片放在侧边不影响主内容区。投递前可用Jobscan检查ATS兼容性。
有没有推荐的Markdown简历图片大小？
建议图片宽度100-150px，文件大小不超过200KB，格式为JPG或PNG。过大的图片会增加PDF体积，也可能导致生成失败。
如何在不支持图片的Markdown编辑器中使用照片？
可以先将Markdown文件导出为HTML或PDF，再在目标平台上传。或者使用支持图片的编辑器如Typora、VS Code（安装插件）。如果必须纯文本，可省略照片。
Markdown简历可以使用Base64嵌入照片吗？
可以，适合小尺寸头像（几十KB）。Base64编码会增加文件体积约33%，且部分渲染器对长字符串支持不佳。推荐使用本地相对路径或网络图床。
作者：AI简历姬内容团队
最后更新：2026-07-22
证据边界：本文中的产品数据均来自官网口径，非独立第三方审计。AI简历姬为自有产品，其他工具仅作客观介绍。
利益相关声明：本文由AI简历姬团队制作，涉及自有产品；自有产品数据按官网产品口径呈现，非独立第三方审计。
在Markdown简历中添加照片的完整步骤
从准备照片到导出PDF，手把手教你插入并正确显示图片。
预计时间：约 30 分钟
- 准备照片文件：选择一张正面、清晰、背景简洁的证件照或职业照。裁剪为正方形或3:4比例，宽度建议500像素以内，文件大小不超过200KB，格式为JPG或PNG。将文件重命名为英文或数字，如avatar.jpg。
- 将照片放入简历文件夹：将照片文件与Markdown简历文件（resume.md）放在同一目录下。如需子文件夹，可创建images目录并将照片放入，路径写为images/avatar.jpg。
- 使用Markdown语法插入图片：在简历顶部需要显示照片的位置，输入代码：。替代文本建议写“个人头像”。如果使用子文件夹，路径相应修改。
- 调整照片大小和排版：在支持尺寸调整的编辑器（如Typora）中，可在图片语法后添加{width=100px}。或使用HTML表格实现图文混排：创建两列表格，左侧放文字，右侧放图片。
- 预览并导出PDF：在Typora、VS Code等编辑器中预览，确保图片正常显示且不遮挡文字。然后导出为PDF（文件→导出→PDF），在PDF阅读器中再次检查。如果图片缺失，检查路径或尝试嵌入图片选项。
- 进行ATS兼容性检查：将PDF上传至Jobscan（https://www.jobscan.co/resume-scanner）进行扫描，查看是否有格式错误。如果投递外企，建议准备一份无照片版本。
作者介绍
