Saltar al contenido principal
Mintlify sirve automáticamente recursos 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. Esto funciona para cualquier tipo de archivo que quieras poner a disposición de tus usuarios, incluidos imágenes, PDF, videos o esquemas. Los archivos deben pesar menos de 20 MB para imágenes y 100 MB para otros tipos de archivo.

Extensiones de archivo compatibles

Mintlify admite las siguientes extensiones de archivos estáticos.

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 documento

  • .pdf
  • .txt
  • .doc, .docx
  • .xls, .xlsx
  • .ppt, .pptx
  • .rtf
  • .odt, .ods, .odp

Formatos de datos

  • .csv
  • .tsv
  • .xml

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. Siguiendo el ejemplo anterior, assets/whitepaper.pdf estaría disponible en https://docs.your-project.com/assets/whitepaper.pdf.
I