Archivos

Sirve recursos estáticos desde tu documentación

Mintlify sirve automáticamente recursos estáticos desde el repositorio de tu 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, videos y más.

Los archivos deben ser de menos de 20 MB para imágenes y 100 MB para otros tipos de archivos.

​

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 documento solo están disponibles en los planes Enterprise.

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

• .csv
• .tsv
• .xml

​

Formatos de archivo comprimido

Los formatos de archivo comprimido solo están disponibles en los planes Enterprise.

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