Typemark Documentation

画像

ドラッグ、貼り付け、またはスラッシュコマンドでページに画像を追加します。

2026年11月19日更新

エディターで追加した画像は、プロジェクトの Git リポジトリ内の images/ フォルダーに保存されるため、ドキュメントと一緒に管理されます。

画像の追加

ビジュアルモードで画像を追加する方法は 3 つあります。

  1. ドラッグ&ドロップ

    コンピューター上の画像ファイルをエディターにドラッグします。

  2. 貼り付け

    画像をコピーするか、スクリーンショットを撮影し、Cmd+V でエディターに貼り付けます。

  3. スラッシュコマンド

    /image と入力し、Enter を押して、コンピューターから画像を選択します。

Typemark はファイルをアップロードし、画像をページに追加します。アップロードに失敗した場合は、サポートされていないファイル形式であるなど、理由がメッセージで表示されます。

対応フォーマット

フォーマット拡張子用途
PNG.pngスクリーンショットや図
JPEG.jpg, .jpeg写真
GIF.gif短いアニメーション
SVG.svgロゴやベクター画像
WebP.webp同程度の品質でファイルサイズを小さくしたい場合

サイズと代替テキスト

画像をクリックすると、ツールバーが表示されます。

  • S、M、L で幅をそれぞれ 320、480、720 ピクセルに設定します。Original を選ぶと幅の指定を解除します。
  • 画像の端にあるハンドルをドラッグすると、任意の幅に設定できます。
  • 代替テキストの欄には、スクリーンリーダーや検索エンジン向けに画像の説明を入力します。
  • 削除ボタンを押すと、画像がページから削除されます。ファイル自体はリポジトリに残ります。

幅を指定していない画像は Markdown として保存されます。幅を指定した画像は <img> タグとして保存されます。

![Dashboard overview](/images/dashboard-overview.png)

<img src="/images/dashboard-overview.png" alt="Dashboard overview" width="480" />

画像の保存方法

画像を追加すると、Typemark は次の処理を行います。

  1. ファイルをリポジトリの images/ に、ファイル名を小文字にして保存します
  2. コミットし、プロジェクトが接続されている場合は GitHub にプッシュします
  3. 画像をページに追加します

ソースモードでは、エディターでアップロードした画像はエディター側のファイルを指しており、そのパスは /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 のままです。