Respuesta rápida: PNG es mejor para compartir algo estático, no para seguimiento vivo
Un GitHub contribution PNG es una imagen estática de la actividad de contribuciones. Funciona bien en un caso de portafolio, artículo, presentación o vista social donde el resultado no debe cambiar después de publicarse.
No trates el PNG como fuente de verdad. La fuente sigue siendo el GitHub contribution graph y las reglas de contribución de GitHub. Si faltan commits o actividad privada en el gráfico oficial, el PNG solo congela ese problema.
Para un README de perfil suele ser mejor una tarjeta SVG viva, un widget de estadísticas o github-profile-3d-contrib. Para una vista más inmersiva, abre GitHub City y convierte la actividad en una ciudad 3D.
PNG vs SVG vs visuales 3D de contribuciones
El formato correcto depende de dónde vivirá el visual. PNG es simple y portátil, pero no se actualiza solo. SVG es más nítido para tarjetas de README y puede generarse dinámicamente. Un visual 3D es mejor para exploración o storytelling.
Mantén cada formato en su función para no llenar el README con imágenes decorativas ni perder claridad sobre la actividad real.
Elige los datos fuente
Empieza con el gráfico oficial de GitHub o un generador confiable. Confirma usuario, rango de año y visibilidad privada antes de exportar.
Usa PNG solo para publicación fija
Elige PNG para slides, portafolios estáticos, imágenes de artículos, previews sociales o documentación.
Usa SVG para actualizaciones en README
Si el visual estará en un README y debe actualizarse, prefiere SVG o un asset generado por workflow.
Usa GitHub City para explorar
Si el lector debe interactuar, rotar una ciudad o comparar densidad de actividad, enlaza GitHub City.
Flujo práctico para un GitHub Contribution PNG
Primero confirma que el gráfico oficial cuenta la historia correcta. Luego usa un generador o captura que mantenga legibilidad al tamaño final. Por último, añade contexto junto a la imagen para que el lector sepa si es una instantánea, una tarjeta viva o un visual 3D.
En un README evita subir un PNG estático y olvidarlo. Si importa la frescura, usa SVG generado o un workflow automático.
| Formato | Mejor para | Actualización |
|---|---|---|
| PNG de contribuciones | Casos de portafolio, blogs, slides y previews | Instantánea estática; se actualiza manualmente |
| Tarjeta SVG README | Secciones de README y badges ligeros | Puede refrescarse con servicio alojado o workflow |
| Imagen 3D de contribuciones | Visuales de perfil y resúmenes anuales | Normalmente generada por workflow; revisa cada salida |
| Vista 3D GitHub City | Exploración interactiva y storytelling | Experiencia en navegador basada en datos visibles |
Mejores usos para un GitHub Contribution PNG
Usa una imagen estática cuando la estabilidad importa más que la frescura. Usa otro formato si debe actualizarse o ser interactiva.
Prueba de portafolio
Un PNG funciona bien para describir un año, proyecto o sprint concreto.
Slide de presentación
Las slides necesitan visuales estables y sin fallos remotos.
Ilustración de artículo
El PNG apoya la guía, pero la conclusión debe estar en texto HTML.
Cuidado en README
Los PNG estáticos envejecen. Prefiere una tarjeta viva o una sección de README template.
Solución de problemas: por qué el PNG se ve mal
Si la imagen se ve vacía o incompleta, diagnostica los datos antes de cambiar la exportación. Revisa email de commit, rama, forks, visibilidad privada y retrasos de actualización.
Si se ve borrosa, exporta a mayor tamaño y comprime una sola vez. No metas textos pequeños dentro de la imagen; explica en texto rastreable.
Regla de decisión
PNG para publicación fija, SVG o tarjetas generadas para README vivo, y GitHub City para exploración interactiva.
FAQ
¿Cómo hago un GitHub contribution PNG?
Confirma el gráfico oficial o un generador confiable, exporta una imagen de alta resolución y úsala cuando deba quedar fija.
¿PNG es mejor que SVG para README?
Normalmente no. SVG o tarjetas generadas son mejores para nitidez y actualización.
¿Puede mostrar contribuciones privadas?
Solo puede mostrar la actividad visible o anonimizada que expone el gráfico fuente.
¿Por qué faltan commits?
El PNG refleja el gráfico fuente. Revisa email, rama, forks, privacidad y tiempo de actualización.
¿Debo usar GitHub City?
Sí, si quieres una ciudad 3D interactiva; PNG si necesitas un asset estático.