アセット配置

対応状況: 標準。 VitePress では用途に応じて public とソースに同居するアセットを選びます。

配置	参照	ビルド後の性質
docs/public/assets/	/assets/vitepress-demo.svg	名前を維持してコピーされる
docs/ja/criteria/	./demo-asset.svg	Vite のアセットとして処理される

公開ファイルは base を意識したサイト内 URL として /assets/vitepress-demo.svg を使います。VitePress は公開時にサイトの base を考慮します。対して相対参照 ./demo-asset.svg は、その Markdown と同じディレクトリーにあるファイルを指します。

使い分け

固定名で外部からも参照したいファイルは public に置きます。ページに密接な画像でハッシュ化・インライン化の候補にしたい場合は Markdown と同居させます。