CodeBox Hub
GRATIS

Cómo añadir un código QR a tu perfil de GitHub

Añade un código QR a tu perfil de GitHub en 5 minutos: genéralo, aloja la imagen y enlázala en el README del perfil. Sin hacks ni terceros.

# Cómo añadir un código QR a tu perfil de GitHub

Un código QR en un perfil de GitHub es un puente pequeño: escanéalo con el teléfono y aterrizas en tu portafolio, tu currículum, tu web o tu vCard, sin teclear una sola letra. La instalación toma cinco minutos y no requiere ningún hack: una imagen generada, un sitio donde alojarla y una línea en el README del perfil. Aquí tienes todo el camino, paso a paso.

Paso 1: decide qué debe abrir el código

Un código QR, un destino. Las mejores opciones para un perfil:

  • Tu portafolio o web personal (URL)
  • Tu currículum como enlace a un PDF
  • Tu vCard para guardar el contacto en un toque (Generador de QR vCard)
  • Una página de contacto con email, LinkedIn y teléfono

Evita llenarlo: un QR que abre un menú de diez opciones desdibuja el punto. Un destino claro, elegido con la misma lógica que la sección "About" del perfil.

Paso 2: genera el código

Abre el Generador de códigos QR gratuito e introduce la URL de destino. Ajustes que funcionan para una imagen de perfil:

  • Corrección de errores H: la imagen vivirá a tamaño pequeño y puede comprimirse en el pipeline de imágenes de GitHub.
  • Negro sobre blanco: máximo contraste, sin sorpresas de render en tema claro u oscuro.
  • SVG para el original y un PNG de 512×512 px para el commit.

Descarga ambos. El SVG es tu maestro; el PNG es lo que entra en el repositorio.

Paso 3: aloja la imagen

GitHub renderiza las imágenes del README del perfil desde dos fuentes:

  1. El propio repositorio: añade el PNG a assets/ en tu repositorio de perfil (el que se llama <username>/<username>) y refiérete a él con la ruta relativa assets/qr-code.png.
  2. Una URL raw: si prefieres, la imagen puede vivir en cualquier repositorio que controles y enlazarse con la URL completa https://raw.githubusercontent.com/....

La opción 1 es la más limpia: la imagen muere con el repositorio, no con un enlace externo.

Paso 4: añádelo al README del perfil

En el README.md de tu repositorio de perfil, añade una sección:

```markdown

Contacto

<p align="center">

<img src="assets/qr-code.png" alt="Código QR a mi portafolio" width="160" />

</p>

Escanea para abrir mi portafolio

```

Commit y push. GitHub actualiza el perfil en un minuto. El width="160" mantiene el código en la franja de 12-16 cm en pantalla de teléfono — lo bastante grande para escanearlo, lo bastante pequeño para no dominar el perfil.

Paso 5: pruébalo como lo vería un visitante

  1. Abre tu perfil en un teléfono (no en escritorio, no en el repositorio — el perfil renderizado).
  2. Apunta la cámara al código y confirma que decodifica el destino exacto.
  3. Prueba en modo oscuro y modo claro: la zona de silencio debe seguir siendo blanca en ambos.
  4. Si falla, comprueba la URL de la imagen en la página renderizada — una ruta relativa rota es la causa más común.

Estático vs dinámico para un perfil

Un código estático es el valor por defecto: la URL queda grabada en la imagen, sin dependencias y funciona para siempre. Un QR dinámico solo tiene sentido si esperas cambiar el destino a menudo (una migración de portafolio) — entonces el código del perfil permanece y el redireccionamiento cambia detrás. La comparativa completa está en Códigos QR estáticos frente a dinámicos.

FAQ

¿GitHub permite imágenes en el README del perfil?

Sí. El README del perfil (repositorio `<username>/<username>`) renderiza Markdown con imágenes, desde el propio repositorio o desde una URL raw.

¿Qué tamaño debe tener el QR en el perfil?

Renderizado entre 120 y 180 px de ancho en la página (`width="160"` es un buen valor por defecto). Más grande ocupa espacio; más pequeño se vuelve difícil de escanear en pantalla de teléfono.

¿Puede el QR apuntar a mi propio perfil de GitHub?

Sí — un código de URL hacia `https://github.com/<username>`. Es un detalle útil en material impreso (credenciales de congreso, pegatinas) que debe llevar al perfil.

Mi QR no se escanea en el perfil renderizado. ¿Qué reviso?

Primero la URL de la imagen (abre la imagen raw en el navegador), después la zona de silencio (sin recortes ni bordes) y después el tamaño. Un enlace roto renderiza un marcador, no un código escaneable.

¿Debo añadir un logo al código?

Solo si lo generaste con nivel H. A tamaño de perfil, un logo de tamaño real se come el presupuesto de corrección; negro sobre blanco y sin más es la opción robusta para una imagen de perfil.

¿Puedo usar el mismo QR en mi currículum y en mi perfil?

Sí, si el destino es el mismo. Un código por destino: si el currículum abre un PDF y el perfil abre el portafolio, son dos códigos.

¿El código deja de funcionar si elimino el repositorio?

Si la imagen vive en el repositorio de perfil y el README la enlaza de forma relativa, borrar el repositorio elimina la imagen y rompe la sección del perfil. Mantén la imagen en un repositorio que no vayas a borrar, o regenera cuando haga falta.

¿Cómo actualizo el destino sin tocar el README?

Solo con un QR dinámico: la imagen (una URL de redirección) permanece en el perfil y cambias el destino en el generador. Con un código estático, el destino está en los píxeles — regenerar es la única vía.

Sigue leyendo

Contáctanos