GitHub Pages aloja sitios web estáticos directamente desde un repositorio de GitHub, gratis y sin necesidad de contratar hosting aparte. Es la opción habitual para portafolios personales, páginas de documentación técnica o landings sencillas que no necesitan base de datos ni backend. Aquí tienes el proceso completo, del repositorio vacío a la web publicada.
Qué es GitHub Pages y cuándo tiene sentido usarlo
Es un servicio de GitHub para publicar webs directamente desde un repositorio Git, pensado para proyectos que se pueden resolver con HTML, CSS y JavaScript sin servidor propio: portafolios, blogs sencillos o páginas de documentación. No hace falta experiencia previa en programación para publicar algo funcional, aunque sí conviene saber lo básico de Git para gestionar los cambios con comodidad.
Ventajas de GitHub Pages
- Gratuito: sin coste de hosting para proyectos públicos.
- Integrado con Git: cada cambio queda versionado, lo que facilita colaborar o volver atrás si algo se rompe.
- Compatible con Jekyll: permite generar sitios con plantillas y Markdown sin escribir HTML a mano.
- Dominio propio: puedes apuntar tu dominio personalizado en lugar de usar la URL de github.io.
Pasos para publicar tu sitio
1. Crea el repositorio
- Inicia sesión en tu cuenta de GitHub.
- Pulsa «New» en la página de repositorios.
- Si quieres que tu sitio quede accesible en
https://<tu-usuario>.github.io, el repositorio tiene que llamarse exactamente<tu-usuario>.github.io. - Marca el repositorio como público y activa «Initialize this repository with a README».
- Pulsa «Create repository».
2. Sube los archivos de tu web
Puedes subir los archivos desde la interfaz web o usando Git en tu ordenador, según lo cómodo que te sientas con la línea de comandos.
Desde la interfaz web
- Entra en tu repositorio.
- Pulsa «Add file» y luego «Upload files».
- Arrastra tus archivos HTML, CSS y JavaScript, o selecciónalos desde tu equipo.
- Confirma con «Commit changes».
Desde la terminal con Git
Clona el repositorio en tu máquina:
git clone https://github.com/<tu-usuario>/<tu-repositorio>.gitCopia tus archivos en la carpeta clonada y sube los cambios:
git add .
git commit -m "Publicar sitio web"
git push origin main3. Activa GitHub Pages
- Entra en «Settings» del repositorio.
- Baja hasta la sección «GitHub Pages».
- Selecciona la rama que quieres publicar, normalmente main.
- Pulsa «Save».
GitHub tarda un par de minutos en generar la URL y publicar el sitio.
4. Accede a tu web publicada
El sitio queda disponible en https://<tu-usuario>.github.io, o en tu dominio propio si lo has configurado. Abre esa dirección en el navegador para verlo en vivo.
Personalizar con Jekyll
Si quieres algo más elaborado que HTML plano, Jekyll viene integrado en GitHub Pages y permite trabajar con plantillas y Markdown. Basta con añadir un archivo _config.yml en la raíz del repositorio y seguir la documentación oficial de Jekyll para elegir tema y estructura.
Cuándo conviene más un CMS que un sitio estático
GitHub Pages funciona muy bien para portafolios y documentación, pero tiene límites claros: sin base de datos ni backend, no hay forma nativa de gestionar un blog con muchos autores, un formulario que guarde datos o un catálogo que cambie a diario. Cuando el proyecto crece hasta ese punto, suele compensar más migrar a WordPress, revisando antes los requisitos básicos para que un proyecto web funcione a largo plazo, o valorar directamente una arquitectura headless si el equipo necesita separar el contenido de la presentación, algo que explicamos en headless WordPress: ventajas reales para SEO, UX y escalabilidad.
Para un portafolio personal o la documentación de un proyecto, GitHub Pages sigue siendo la opción más rápida y barata de tener algo publicado en internet en cuestión de minutos.
Preguntas frecuentes
¿GitHub Pages tiene algún coste?
No, es gratuito tanto para repositorios públicos como, con limitaciones, para privados en cuentas de pago de GitHub.
¿Puedo usar mi propio dominio en lugar de github.io?
Sí, GitHub Pages permite vincular un dominio personalizado configurando los registros DNS correspondientes desde el panel de tu proveedor de dominio.
¿Sirve GitHub Pages para un blog con varios autores?
No de forma nativa. Al no tener base de datos ni backend, para un blog con gestión de usuarios y contenido dinámico conviene más un CMS como WordPress.
¿Necesito saber programar para publicar en GitHub Pages?
No es imprescindible para subir archivos HTML ya hechos, pero conocer lo básico de Git facilita gestionar cambios y evita errores al actualizar el sitio.
