# 文件 (/zh/create/files)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 259 · updated: 2026-07-30 -->
Related: [更新日志](/zh/create/changelogs.md), [格式化代码](/zh/create/code.md), [图片与嵌入](/zh/create/image-embeds.md), [列表与表格](/zh/create/list-table.md), [个性化内容](/zh/create/personalization.md), [重定向](/zh/create/redirects.md)

Mintlify 会自动从你的文档存储库中，在你的 domain 上的相应路径提供静态资产。例如，如果你的仓库中有 `/images/logo.png`，该图片文件可通过 `https://docs.your-project.com/images/logo.png` 访问。

你可以向用户提供任何受支持的文件类型，包括 OpenAPI 规范、图片、视频等。

文件大小必须小于 20 MB。

<Note>
  对于启用了认证的文档站点，不支持文件服务。如果你的站点需要认证，静态文件无法通过其直接 URL 访问。
</Note>

<div id="supported-file-types">
  ## 支持的文件类型 [#支持的文件类型]
</div>

所有方案支持的文件类型：

* **图片**：`.png`、`.jpg`、`.jpeg`、`.gif`、`.webp`、`.svg`、`.ico`
* **视频**：`.mp4`、`.webm`
* **音频**：`.mp3`、`.wav`
* **数据**：`.json`、`.yaml`
* **样式表**：`.css`
* **脚本**：`.js`
* **字体**：`.woff`、`.woff2`、`.ttf`、`.eot`

Enterprise 方案支持的文件类型：

* **文档**：`.pdf`、`.txt`
* **数据**：`.xml`、`.csv`
* **压缩包**：`.zip`

<div id="file-organization">
  ## 文件结构 [#文件结构]
</div>

使用文件夹来组织文件，使你的存储库更易于浏览：

```text
/your-project
  |- docs.json
  |- images/
    |- logo.png
    |- screenshots/
      |- dashboard.png
  |- assets/
    |- whitepaper.pdf
    |- demo-video.mp4
```

Mintlify 会从你的 domain 根目录提供文件，因此存储库中的结构会直接映射到 URL 结构。依据前面的示例，`assets/whitepaper.pdf` 可通过 `https://docs.your-project.com/assets/whitepaper.pdf` 访问。