文件

从文档中提供静态资源

Mintlify 会在你的 domain 对应路径下，自动从文档存储库提供静态资源。举例来说，如果你的存储库中有 /images/my-logo.png，则可通过 https://docs.your-project.com/images/my-logo.png 访问该图片文件。

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

图片必须小于 20 MB，其他文件类型必须小于 100 MB。

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

​

支持的文件类型

​

图像格式

• .jpeg, .jpg, .jfif, .pjpeg, .pjp
• .png
• .svg, .svgz
• .ico
• .webp
• .gif, .apng
• .avif
• .bmp
• .tiff, .tif

​

视频格式

• .mp4
• .webm
• .ogg
• .avi
• .mov
• .wmv
• .flv
• .mkv
• .m4v

​

音频格式

• .mp3
• .wav
• .flac
• .aac
• .ogg
• .wma
• .m4a

​

字体格式

• .woff
• .woff2
• .ttf
• .otf
• .eot

​

文档格式

文档格式仅适用于 Custom 订阅计划，且在启用认证时不支持。

• .pdf
• .txt
• .doc, .docx
• .xls, .xlsx
• .ppt, .pptx
• .rtf
• .odt, .ods, .odp

​

数据格式

数据格式仅适用于 Custom 计划，且在启用认证后不支持使用。

• .csv
• .tsv
• .xml

​

归档格式

归档格式仅适用于 Custom 方案，在启用认证时不支持。

• .zip
• .rar
• .7z
• .tar
• .gz
• .bz2

​

文件结构

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

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

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