# Markdownの画像

> Markdownで画像を挿入する方法。![代替テキスト](URL)の書き方と、AIが実際に読むのは代替テキストだという話。

## 基本の書き方

リンクの先頭に感嘆符を付けた形です。角かっこに代替テキスト、丸かっこに画像のパスかURLを入れます。

```markdown
![A cat asleep on a keyboard](cat.jpg)
```

## AIが読むのは代替テキスト

角かっこの中の文字が「代替テキスト」です。スクリーンリーダーやAIは画像そのものではなくこの文字を読むので、画像の要点を言葉で書きましょう。

## 参照形式の画像

画像をラベルで一度定義し、ラベルを使い回します。同じ画像を何度も使うときに便利です。

```markdown
![Our logo][logo]

[logo]: /logo.png
```

:::tip
AIにとって、代替テキストが空の画像は存在しないのと同じです。必ず中身を説明しましょう。グラフなら「グラフ」ではなく、何が読み取れるかを書きます。
:::