Qué es realmente un README de perfil
Un README de perfil es un documento breve que GitHub muestra en la parte superior de tu página de perfil.
Es uno de los pocos lugares donde controlas lo primero que lee un visitante, antes de que vea tus repositorios o tu actividad de contribuciones.
Eso lo convierte en una herramienta útil, pero no está libre de contrapartidas y solo funciona si se cumplen algunas condiciones técnicas.
Esta guía cubre qué puede hacer un README de perfil, los requisitos exactos de GitHub para mostrarlo y qué puede hacerlo desaparecer.
También te ayuda a decidir si agregar uno se ajusta a tu situación.
Según la documentación de GitHub, un README de perfil es una sección personalizable en la parte superior de tu página de perfil.
Tú decides qué incluir, lo que te da control total sobre cómo te presentas.
La documentación de perfil de GitHub lo enumera junto con tu biografía, la actividad de contribuciones, los elementos fijados, el estado y los logros.
Como está escrito en Markdown, puedes dar formato al texto e incluir emojis, imágenes y GIF usando GitHub Flavored Markdown.
GitHub sugiere contenidos que los visitantes pueden encontrar útiles, como una sección «sobre mí» que describa tu trabajo e intereses.
También recomienda destacar contribuciones de las que estés orgulloso, con contexto sobre ellas.
En la práctica, eso significa que el README no es un duplicado de tu currículum.
Es una orientación breve para el visitante: quién eres, en qué trabajas y dónde debería mirar después.
Los requisitos: cuándo GitHub muestra tu README
GitHub muestra tu README de perfil solo si se cumplen todas las siguientes condiciones, según la documentación de README de perfil de GitHub:
- Has creado un repositorio con un nombre que coincida con tu nombre de usuario de GitHub.
- El repositorio es público.
- El repositorio contiene un archivo llamado README.md en su raíz.