「一图胜千言」。README 顶部放一张截图或 GIF,访客无需安装就能判断要不要继续。
放什么
- 产品截图:GUI / Web 项目最该放。
- 终端 GIF:CLI 工具展示一次完整命令流程。
- 在线 Demo 链接:能点开体验最佳。
怎么放

图片建议放仓库 docs/ 或外链图床;GitHub 会按原尺寸渲染,注意别太大(建议宽度 ≤ 1000px)。
避坑
- 别只放 Logo,要放「用了之后长什么样」。
- GIF 控制在几秒、文件别超 5MB,否则加载慢。
- Demo 链接失效是大忌,定期检查。
工具生成的是文本骨架,截图部分留给你补——位置建议在标题下方、特性之前。
立即使用 AI README 生成器 →