Saltar al contenido principal
Mintlify sirve automáticamente activos estáticos desde tu repositorio de documentación en la ruta correspondiente de tu domain. 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, vídeos y más. Los archivos deben ser menores de 20 MB para 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 archivo compatibles

Tipos de archivo compatibles para todos los planes:
  • Imágenes: .png, .jpg, .jpeg, .gif, .webp, .svg, .ico
  • Vídeo: .mp4, .webm
  • Audio: .mp3, .wav
  • Datos: .json, .yaml
  • Hojas de estilo: .css
  • Scripts: .js
  • Fuentes: .woff, .woff2, .ttf, .eot
Tipos de archivo compatibles para los planes Custom:
  • Documentos: .pdf, .txt
  • Datos: .xml, .csv
  • Archivos comprimidos: .zip

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.