Archivos

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/logo.png en tu repositorio, el archivo de imagen estará disponible en https://docs.your-project.com/images/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.

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

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

Mintlify sirve los archivos 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.