基础语法 / 图片
图片
图片通常用于放界面截图、流程图和示意图。比起“见下图”这种空话,更重要的是图片文件名、替代文字和上下文是否真正有信息量。
基本语法
 替代文字(alt text)要描述这张图想传达什么,例如“深色模式下的首页导航截图”,而不是简单写成“图片 1”。
示例
 带链接的图片
如果你想让图片点击后跳到原图、仓库或详细说明页,可以把图片语法放进链接里:
[](https://github.com/Albert-Lsk/Markdown-Tutorial) 最佳实践
- 优先使用相对路径引用仓库里的资源,避免外链失效导致文档“只剩替代文字”。
- 截图类图片尽量裁掉无关区域,读者打开后应该能直接看到重点。
- 文件名也写清楚用途,例如
home-dark-mode.png,比image-1.png更易维护。 - 如果一张图无法独立说明问题,补一句上下文,而不是堆更多装饰性图片。
评论
评论区暂未开放。
需要先为这个仓库启用 GitHub Discussions,并完成 giscus 配置后,评论功能才可用。