Generador de README de perfil de GitHub

Resultados

Crear un repositorio cuyo nombre coincida con tu nombre de usuario de GitHub te da un README que aparece en la parte superior de tu página de perfil. Este generador produce un archivo Markdown limpio para ese repositorio: encabezado, breve biografía, stack tecnológico y tarjetas de estadísticas opcionales impulsadas por github-readme-stats.

Cómo construir el README del perfil

  1. 1

    Completa tus detalles

    Nombre para mostrar, lema, ubicación, en qué estás trabajando y aprendiendo.

  2. 2

    Agrega tu stack tecnológico

    Lista separada por comas; cada elemento se renderiza como un chip en negrita.

  3. 3

    Habilita las tarjetas de estadísticas

    Las tarjetas de estadísticas de GitHub y de lenguajes principales se renderizan en vivo desde github-readme-stats; la opción de actividad añade un enlace a tu gráfico de contribuciones.

  4. 4

    Copia el Markdown

    Crea un repositorio llamado como tu nombre de usuario y sube el README.md en la raíz.

Cómo funciona el “repositorio especial”

Si tu nombre de usuario es alex y creas un repositorio público llamado alex, GitHub renderiza el README.md de ese repositorio en tu perfil (sobre Repositorios populares). Es una función documentada, no un hack.

Tarjetas que el generador puede incrustar

Tarjeta URL de origen Notas
Estadísticas de GitHub github-readme-stats-one-bice.vercel.app/api?username=...&show_icons=true Commits, PRs, issues
Lenguajes principales github-readme-stats-one-bice.vercel.app/api/top-langs/?username=... Desglose de lenguajes por tamaño de repositorio
Actividad de contribución github.com/{username}?tab=overview Enlace que se muestra al activar “Racha”

Las dos tarjetas de estadísticas son puntos finales PNG y se renderizan en cualquier visor de Markdown, incluso cuando alguien carga tu perfil sin autenticarse; el enlace de actividad abre tu gráfico de contribuciones en GitHub.

Contenido que se lee bien

  • Lema de una línea: rol + enfoque (“Ingeniero de infra de Rust, interesado en trazado”).
  • Máximo 3–5 puntos sobre el stack; más y se escanea como un CV.
  • Habilidades como chips, no un párrafo. Los lectores escanean por tecnología.
  • Enlaces a proyectos que realmente mantienes. Repositorios abandonados fijados en el perfil son peores que no tener ninguno.
  • Línea de contacto: correo electrónico o un solo perfil social; evita listar seis redes.

Qué no poner allí

  • Direcciones privadas o números de teléfono.
  • Copia para reclutadores (“Abierto a trabajar” pertenece a LinkedIn o a la opción de banner de GitHub).
  • Emojis en cada línea, uno o dos están bien, una jungla es ruido.

Preguntas frecuentes

github-readme-stats está alojado en Vercel y ocasionalmente limita la tasa o almacena en caché datos obsoletos. Si una tarjeta falla, espera unos minutos o aloja el proyecto tú mismo, el repositorio tiene un botón de despliegue en Vercel de un clic.

Solo si autenticas el servicio con un token que tiene el alcance repo. Por defecto, las estadísticas cuentan solo los commits públicos, que suele ser la decisión correcta en un perfil público.

Sí. GitHub permite un subconjunto de HTML en Markdown, <img>, <details>, <sub>, <sup> y estilos en línea simples. Los scripts y formularios se eliminan por seguridad.

No. Los valores que escribes se envían a nuestro servidor para generar la vista previa y, en la vista de varios pasos, se trasladan en el enlace de la página entre pasos. No se almacena nada en una base de datos y todo se descarta al cerrar la pestaña.

Herramientas relacionadas

Herramienta disponible en otros idiomas