Skip to content

画像構文

画像はドキュメントにおける重要な視覚的要素です。Markdownは、画像の挿入と管理のための簡潔な構文を提供します。

基本的な画像構文

インライン画像

![代替テキスト](画像URL) 形式を使用します:

markdown
![Markdownロゴ](https://www.markdownlang.com/markdown-logo.png)

タイトル付き画像

オプションのタイトルを追加します:

markdown
![Markdownロゴ](https://www.markdownlang.com/markdown-logo.png "公式Markdownロゴ")

画像にホバーすると、タイトルテキストが表示されます。

参照形式の画像

基本的な参照形式

markdown
![代替テキスト][画像参照]

[画像参照]: https://www.markdownlang.com/image.jpg "オプションのタイトル"

ショートカット参照形式

参照ラベルが代替テキストと同じ場合:

markdown
![Markdownロゴ][]

[Markdownロゴ]: https://www.markdownlang.com/markdown-logo.png

画像パスの種類

絶対URL

markdown
![Web画像](https://www.markdownlang.com/images/photo.jpg)

相対パス

markdown
![ローカル画像](./images/photo.jpg)
![親ディレクトリの画像](../images/photo.jpg)
![同じディレクトリの画像](photo.jpg)

ルート相対パス

markdown
![ルートディレクトリの画像](/images/photo.jpg)

高度な画像機能

画像リンク

画像をリンクでラップします:

markdown
[![画像の説明](image.jpg)](https://www.markdownlang.com)

レンダリング結果: 画像をクリックすると、指定されたリンクにジャンプします。

HTMLを使用した画像の制御

サイズ指定

markdown
<img src="image.jpg" alt="説明" width="300" height="200">

画像の配置

markdown
<!-- 中央揃え -->
<div align="center">
  <img src="image.jpg" alt="中央揃えの画像" width="400">
</div>

<!-- 右揃え -->
<div align="right">
  <img src="image.jpg" alt="右揃えの画像" width="300">
</div>

レスポンシブ画像

markdown
<img src="image.jpg" alt="レスポンシブ画像" style="max-width: 100%; height: auto;">

画像の組み合わせ表示

横並び表示

markdown
<img src="img1.jpg" width="45%"> <img src="img2.jpg" width="45%">

画像グリッド

markdown
<table>
  <tr>
    <td><img src="img1.jpg" width="200"></td>
    <td><img src="img2.jpg" width="200"></td>
  </tr>
  <tr>
    <td><img src="img3.jpg" width="200"></td>
    <td><img src="img4.jpg" width="200"></td>
  </tr>
</table>

画像とテキストの混在

markdown
<img src="avatar.jpg" align="left" width="100" style="margin-right: 10px;">

これは左側に画像がフローティングする段落のテキストです。テキストは画像の周りに折り返され、混合レイアウトを作成します。個人プロファイルや製品紹介に使用できます。

<div style="clear: both;"></div>

代替テキストのベストプラクティス

説明的なテキスト

markdown
✅ 推奨: 画像の内容を説明
![ワークスペースでノートパソコンを使用するユーザー](workspace.jpg)

❌ 推奨されない: 意味のないテキスト
![画像](workspace.jpg)
![ここをクリック](workspace.jpg)

機能的な画像

markdown
✅ 推奨: 画像の機能を説明
![検索ボタン](search-icon.png)
![GitHubリポジトリリンク](github-logo.png)

❌ 推奨されない: 周囲のテキストを繰り返す
クリックして検索 ![クリック](search-icon.png)

装飾的な画像

markdown
✅ 推奨: 装飾的な画像には空の代替テキストを使用
![](decorative-border.png)

❌ 推奨されない: 不要な説明
![装飾的な境界線パターン](decorative-border.png)

一般的な画像形式

Web向けの形式

形式用途特徴
JPEG写真、複雑な画像小さいファイルサイズ、非可逆圧縮
PNGアイコン、透過背景可逆圧縮、透過性をサポート
WebPモダンなWeb画像より小さいサイズ、高品質
SVGベクターグラフィック、アイコンスケーラブル、小さいファイルサイズ
GIFシンプルなアニメーションアニメーションをサポート、色数制限

形式選択のアドバイス

markdown
✅ 推奨される使用法:
![写真](photo.jpg)           ← 写真にはJPEG
![アイコン](icon.png)         ← アイコンにはPNG
![ベクター](logo.svg)         ← ベクターグラフィックにはSVG
![アニメーション](animation.gif)   ← シンプルなアニメーションにはGIF

❌ 推奨されない:
![アイコン](icon.jpg)         ← アイコンにJPEGは不適切
![写真](photo.png)           ← PNGファイルは大きくなる可能性がある

画像最適化のヒント

ファイルサイズの最適化

  1. 適切な解像度を選択

    markdown
    <!-- Web表示に推奨 -->
    <img src="image.jpg" width="800" alt="説明">  ← 高DPIスクリーン用に2倍の画像
  2. 適切な圧縮を使用

    markdown
    <!-- JPEG品質: 70-80%を推奨 -->
    ![最適化された写真](optimized-photo.jpg)
  3. 遅延読み込み

    markdown
    <img src="image.jpg" alt="説明" loading="lazy">

CDNと画像ホスティングの使用

markdown
<!-- 高速化のためにCDNを使用 -->
![CDN画像](https://cdn.example.com/images/photo.jpg)

<!-- 画像ホスティングサービス -->
![ホストされた画像](https://img.example.com/upload/photo.jpg)

一般的なエラーと解決策

1. パスエラー

markdown
❌ エラー:
![画像](images/photo.jpg)    ← パスが存在しない

✅ 正しい:
![画像](./images/photo.jpg)  ← ファイルパスを確認
![画像](/assets/photo.jpg)   ← 正しい相対パスを使用

2. 代替テキストの欠落

markdown
❌ エラー:
![](image.jpg)  ← 代替テキストがない

✅ 正しい:
![画像の説明](image.jpg)  ← 意味のある代替テキストを追加

3. 画像の読み込みエラー

markdown
❌ エラー:
![壊れた画像](broken-image.jpg)  ← 存在しない画像

✅ 正しい:
![代替テキスト](fallback-image.jpg)  ← デフォルト画像を提供

画像の検証とアクセシビリティ

画像の検証

markdown
<!-- 画像の存在を確認 -->
![検証済み画像](https://www.markdownlang.com/verified-image.jpg "画像の検証")

アクセシビリティのヒント

  1. 意味のある代替テキスト
  2. 適切な色のコントラスト
  3. スクリーンリーダーのサポート

HTML出力

Markdownの画像構文はHTMLに変換されます:

markdown
![代替テキスト](image.jpg "タイトル")

変換後:

html
<img src="image.jpg" alt="代替テキスト" title="タイトル">

関連構文

練習

以下の画像関連タスクを試してみてください:

  1. レスポンシブな画像グリッドの作成
  2. タイトルと代替テキストを含む画像の挿入
  3. 画像をリンクでラップ
  4. 異なる形式の画像を比較
  5. アクセシビリティを考慮した画像の最適化

Build by www.markdownlang.com