Saltar al contenido principal
Mintlify sirve automáticamente recursos estáticos desde el repositorio de tu documentación en la ruta correspondiente de tu dominio. Por ejemplo, si tienes /images/my-logo.png en tu repositorio, el archivo de imagen estará disponible en https://docs.your-project.com/images/my-logo.png. Puedes poner a disposición de tus usuarios cualquier tipo de archivo compatible, incluidas especificaciones OpenAPI, imágenes, videos y más. Los archivos deben pesar menos de 20 MB en el caso de las imágenes y 100 MB para otros tipos de archivo.
La entrega de archivos no es compatible para sitios de documentación con la autenticación habilitada. Si tu sitio requiere autenticación, los archivos estáticos no serán accesibles en sus URL directas.

Tipos de archivos compatibles

Formatos de imagen

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

Formatos de vídeo

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

Formatos de audio

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

Formatos de fuente

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

Formatos de documentos

Los formatos de documentos solo están disponibles en planes Custom y no son compatibles cuando la autenticación está habilitada.
  • .pdf
  • .txt
  • .doc, .docx
  • .xls, .xlsx
  • .ppt, .pptx
  • .rtf
  • .odt, .ods, .odp

Formatos de datos

Los formatos de datos solo están disponibles en los planes personalizados y no son compatibles cuando la autenticación está habilitada.
  • .csv
  • .tsv
  • .xml

Formatos de archivo comprimido

Los formatos de archivo comprimido solo están disponibles en los planes Custom y no son compatibles cuando la autenticación está habilitada.
  • .zip
  • .rar
  • .7z
  • .tar
  • .gz
  • .bz2

Organización de archivos

Organiza tus archivos en carpetas para que tu repositorio sea fácil de navegar:
/your-project
  |- docs.json
  |- images/
    |- logo.png
    |- screenshots/
      |- dashboard.png
  |- assets/
    |- whitepaper.pdf
    |- demo-video.mp4
Los archivos se sirven desde la raíz de tu domain, por lo que la estructura de tu repositorio se corresponde directamente con la estructura de la URL. En el ejemplo anterior, assets/whitepaper.pdf estaría disponible en https://docs.your-project.com/assets/whitepaper.pdf.