メディア

そのまま配信したい静的 file は public/media に置きます。MDX ページからは root-relative の /media/... URL で参照できるため、一般的な画像や PDF に import は不要です。source では常にこの形式を使い、Astro の configured base を含めないでください。Oxiquill が Markdown transform 中に追加します。

画像 file

Markdown image syntax が最も短い書き方です。画像内容を説明する具体的な alt text を使います。

![PNG sample with color bands](/media/examples/sample.png)

JPEG file も同じ URL pattern を使います。

![JPEG sample with a grid and gradient](/media/examples/sample.jpg)

PDF

PDF には embedded frame と通常 link の両方を置きます。frame でページ内 preview ができ、link で直接開けます。

<iframe class="media-frame" src="/media/examples/sample.pdf" title="Sample PDF"></iframe>

[Open the PDF in a new tab](/media/examples/sample.pdf)

Open the PDF in a new tab

配置 rule

• public file は public/media に置きます。
• root-relative の /media/... URL で参照し、Astro の configured base は手動で追加しません。
• file 自体が source asset でない限り、生成 media を docs tree に置かないでください。
• test や screenshot が安定するよう、sample file は stable にします。