跳转到主要内容
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 访问。
I