文藝部 The Art Of Documentation

画像記法！

//talk{参照記法からの流れで画像記法を説明するよ}

//talk{画像って、イラストとか写真とかですよね？　流れあるんですか？}

//talk{『ある』、というより『あると思って憶えると便利』って感じかな}

//talk{？}

//talk{あー、じゃあ先に記述例出すね}

```


上の絵のの部分がサトゥルヌスです。

```

//talk{`[]`内に画像のラベル、`()`内が実際の画像の位置だね。画像がちゃんと置いてあって、ツールが対応していれば画像自体がプレビューされたりする。ラベルの部分は代替テキストだったりキャプションだったりとまちまちかな}

//talk{！}

//talk{そう、参照記法の前に`!`が付いている、と憶えられる}

//talk{でも、似たような記法が幾つもあるとどっちがどっちだったかややこしくなる気も}

//talk{参照記法が基本で画像記法はその派生、と捉えると似ていること自体は腑に落ちるのではないかと思う。}

//talk{派生}

//talk{見てきたように、簡易的な記号で様々なコンポーネントを表現するのが軽量マークアップであり、更に一般に約物のように使える記号で書くのがMarkdown。で、『ある内容をテキストで示す』のが参照といえる}

//talk{それはまあ、はい}

//talk{その中で、内容が画像、というより『画像の場所をテキストで示す』という方法で画像を記述する。で、特に画像であることを強調する記号を付けることにする。ツールが画像をそのまま表示できるならそれも可、とするんだね。まあHTMLとかでも画像は基本的には`<img>`の`@src`で参照する書き方だしね}

//talk{なんかぼかされたような……}

//talk{テキストで画像を示そうというのがぼかしといえばぼかしだからねえ。……dataスキーマとかSVGとか直接的な画像の話はしないでいいよね}

//talk{既にキャパオーバーなので……}