Skip to main content
Mintlify 会自动从你的文档存储库中,在你的 domain 上的相应路径提供静态资产。例如,如果你的仓库中有 /images/logo.png,该图片文件可通过 https://docs.your-project.com/images/logo.png 访问。 你可以向用户提供任何受支持的文件类型,包括 OpenAPI 规范、图片、视频等。 文件大小必须小于 20 MB。
对于启用了认证的文档站点,不支持文件服务。如果你的站点需要认证,静态文件无法通过其直接 URL 访问。

支持的文件类型

所有方案支持的文件类型:
  • 图片:.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

文件结构

使用文件夹来组织文件,使你的存储库更易于浏览:
Mintlify 会从你的 domain 根目录提供文件,因此存储库中的结构会直接映射到 URL 结构。依据前面的示例,assets/whitepaper.pdf 可通过 https://docs.your-project.com/assets/whitepaper.pdf 访问。