Archivos

Sirve activos estáticos como imágenes, videos, archivos PDF y archivos de datos desde tu repositorio de documentación con optimización automática y entrega mediante CDN.

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.

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 son 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 Enterprise:

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