画像
ドラッグ、貼り付け、またはスラッシュコマンドでページに画像を追加します。
2026年11月19日更新
エディターで追加した画像は、プロジェクトの Git リポジトリ内の images/ フォルダーに保存されるため、ドキュメントと一緒に管理されます。
画像の追加
ビジュアルモードで画像を追加する方法は 3 つあります。
ドラッグ&ドロップ
コンピューター上の画像ファイルをエディターにドラッグします。
貼り付け
画像をコピーするか、スクリーンショットを撮影し、
Cmd+Vでエディターに貼り付けます。スラッシュコマンド
/imageと入力し、Enterを押して、コンピューターから画像を選択します。
Typemark はファイルをアップロードし、画像をページに追加します。アップロードに失敗した場合は、サポートされていないファイル形式であるなど、理由がメッセージで表示されます。
対応フォーマット
| フォーマット | 拡張子 | 用途 |
|---|---|---|
| PNG | .png | スクリーンショットや図 |
| JPEG | .jpg, .jpeg | 写真 |
| GIF | .gif | 短いアニメーション |
| SVG | .svg | ロゴやベクター画像 |
| WebP | .webp | 同程度の品質でファイルサイズを小さくしたい場合 |
サイズと代替テキスト
画像をクリックすると、ツールバーが表示されます。
- S、M、L で幅をそれぞれ 320、480、720 ピクセルに設定します。Original を選ぶと幅の指定を解除します。
- 画像の端にあるハンドルをドラッグすると、任意の幅に設定できます。
- 代替テキストの欄には、スクリーンリーダーや検索エンジン向けに画像の説明を入力します。
- 削除ボタンを押すと、画像がページから削除されます。ファイル自体はリポジトリに残ります。
幅を指定していない画像は Markdown として保存されます。幅を指定した画像は <img> タグとして保存されます。

<img src="/images/dashboard-overview.png" alt="Dashboard overview" width="480" />
画像の保存方法
画像を追加すると、Typemark は次の処理を行います。
- ファイルをリポジトリの
images/に、ファイル名を小文字にして保存します - コミットし、プロジェクトが接続されている場合は GitHub にプッシュします
- 画像をページに追加します
ソースモードでは、エディターでアップロードした画像はエディター側のファイルを指しており、そのパスは /projects/ で始まります。Typemark は公開されたサイトでこのパスを書き換えるため、変更する必要はありません。
画像を手動で参照する
画像のパスを自分で書く場合は、ドキュメントのルートからのパスを使用します。ファイルが images/setup-wizard.png にある場合、ページの階層に関係なく、どのページからも /images/setup-wizard.png と参照します。
ディレクトリ構造の例
my-docs/
├── typemark.json
├── introduction.mdx
├── guides/
│ └── getting-started.mdx
└── images/
├── logo-light.svg
├── logo-dark.svg
├── setup-wizard.png
└── dashboard-overview.png
guides/getting-started.mdx からでも、セットアップ画面のスクリーンショットは /images/setup-wizard.png のままです。