Files

从文档中提供静态资源

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

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

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

​

支持的文件类型

​

图像格式

• .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

​

文档格式

文档格式仅在 Enterprise 方案中提供。

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

​

数据格式

数据格式仅适用于企业版计划。

• .csv
• .tsv
• .xml

​

归档格式

归档格式仅适用于 Enterprise 方案。

• .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 访问。