Publicado 2026-10-23
# 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:
- 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 relativaassets/qr-code.png. - 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
- Abre tu perfil en un teléfono (no en escritorio, no en el repositorio — el perfil renderizado).
- Apunta la cámara al código y confirma que decodifica el destino exacto.
- Prueba en modo oscuro y modo claro: la zona de silencio debe seguir siendo blanca en ambos.
- 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.