图片与资源

全局静态资源应存放于 public/ 目录，而页面专属资源推荐使用相对路径就近引用。

public/ 目录

public/ 目录下的文件将直接映射至站点根路径（/）。

即便站点部署于子路径下（site.base !== '/'），通常无需手动为 public 静态资源添加 ctx.withBase()（Methanol 构建系统会自动处理路径解析）。

若在 JS（客户端专用组件）中动态生成 URL，并遇到 Vite dev 下资源解析不一致，使用 ctx.withBase('/...') 可有效规避路径问题。

public/
  logo.png
  downloads/
    brochure.pdf

在 MDX 中使用：

![Logo](/logo.png)
[下载手册](/downloads/brochure.pdf)

本地文件

图片亦可放置于页面文件同级目录，并通过相对路径引用：

pages/
  guide/
    writing.mdx
    writing-diagram.png

![Diagram](./writing-diagram.png)

全局样式与脚本注入

若存在 pages/style.css，系统将自动将其注入至所有页面。若存在 pages/index.js 或 pages/index.ts，会作为模块脚本注入到所有页面。

生产构建时这些 URL 会自动适配 Base Path（等价于 ctx.withBase('/style.css') / ctx.withBase('/index.js')）。

<link rel="stylesheet" href="/style.css" />
<script type="module" src="/index.js"></script>