Cambiar el tamaño de las imágenes para archivos README de GitHub
Las imágenes en los archivos README de GitHub deben tener el tamaño adecuado para el contenedor de rebajas (normalmente entre 700 y 900 px de ancho) y optimizarse para una carga rápida. Las imágenes de gran tamaño ralentizan la visualización de la página y desperdician ancho de banda para cada visitante. ImageGates cambia el tamaño de sus capturas de pantalla y diagramas a dimensiones óptimas para GitHub.
Tamaños de imagen para archivos README de GitHub
GitHub presenta el contenido README en una columna de aproximadamente 900 px de ancho en el escritorio y reduce la escala de las imágenes para que quepan. El navegador reduce cualquier cosa más ancha, y las capturas de pantalla del código sufren más con ese remuestreo.
Especificaciones exactas:
- Maximum useful width: 900 px (columna LÉAME)
- Retina-crisp screenshots: 1800 px de ancho, mostrado a 900
- Social preview card: 1280×640 px (2:1)
- Per-file upload ceiling: 10 MB mediante arrastrar y soltar
- Formatos: PNG para UI y código, SVG para diagramas, GIF para demostraciones
Qué causa un resultado rechazado o degradado:
- Enviar capturas de pantalla de 4 MB al repositorio, que luego descarga cada clon.
- Al usar JPG para capturas de pantalla de código o terminal, los bordes del texto se vuelven borrosos.
- Codificar un ancho en HTML que rompa el diseño móvil en lugar de utilizar un archivo redimensionado.
Orden de preparación que evita retrabajos:
- Capture a 2× y cambie el tamaño del lado más largo a 1800 px.
- Exporte PNG para interfaces, SVG para diagramas de arquitectura.
- Comprimir antes de comprometerse; Una captura de pantalla de 200 KB normalmente no se distingue de una de 2 MB.
How to use this tool
- Subir imagen — Select your screenshot, diagram, or banner for the README.
- Cambiar el tamaño a 800-1200 px — Resize to fit GitHub's markdown container width.
- Añadir a LÉAME — Download and reference in your README.md file.
Guide
Las imágenes de buen tamaño en los README de GitHub mejoran la documentación del proyecto y la experiencia del usuario. Cada visitante de su repositorio carga estas imágenes, por lo que la optimización es importante.
Mejores prácticas de imágenes de GitHub: - Resize to 800-1200px wide (matches container) - Utilice PNG para capturas de pantalla con texto - Utilice JPG para contenido fotográfico - Utilice SVG para diagramas y logotipos - Mantenga el peso total de la imagen por debajo de 5 MB por archivo README - Utilice el alojamiento de imágenes de GitHub (arrastre y suelte en los problemas)
Léame tipos de imágenes: 1. Project logo/banner (top of README) 2. Screenshots of the application 3. Architecture diagrams 4. Demo GIFs (keep under 5MB) 5. Badge images (auto-generated, no optimization needed)
Preguntas frecuentes
¿Qué ancho de imagen debo usar para los README de GitHub?
El contenedor de rebajas de GitHub tiene aproximadamente 888 píxeles de ancho. Cargue imágenes con un ancho de 800-1200 px para una visualización nítida. Las imágenes más grandes se escalan automáticamente y desperdician ancho de banda.
¿Qué formato es mejor para las imágenes de GitHub?
PNG para capturas de pantalla y diagramas (texto nítido). JPG para fotografías. SVG para logotipos y gráficos simples. GIF para demostraciones breves.
Abrir cambio de tamaño de imagen