基础语法 / 图片

图片

图片通常用于放界面截图、流程图和示意图。比起“见下图”这种空话,更重要的是图片文件名、替代文字和上下文是否真正有信息量。

基本语法

![替代文字](图片地址)

替代文字(alt text)要描述这张图想传达什么,例如“深色模式下的首页导航截图”,而不是简单写成“图片 1”。

示例

![深色模式下的首页截图](./images/home-dark-mode.png)

带链接的图片

如果你想让图片点击后跳到原图、仓库或详细说明页,可以把图片语法放进链接里:

[![部署流程示意图](./images/deploy-flow.png)](https://github.com/Albert-Lsk/Markdown-Tutorial)

最佳实践

  • 优先使用相对路径引用仓库里的资源,避免外链失效导致文档“只剩替代文字”。
  • 截图类图片尽量裁掉无关区域,读者打开后应该能直接看到重点。
  • 文件名也写清楚用途,例如 home-dark-mode.png,比 image-1.png 更易维护。
  • 如果一张图无法独立说明问题,补一句上下文,而不是堆更多装饰性图片。

评论

评论区暂未开放。

需要先为这个仓库启用 GitHub Discussions,并完成 giscus 配置后,评论功能才可用。