Cómo empezar con Astro: crea un blog rápido y optimizado
Astro es un framework web para sitios centrados en contenido, como blogs y documentación. No envía JavaScript al navegador salvo que un componente lo pida, acepta componentes de React, Vue y Svelte, y organiza tus artículos en Markdown con Content Collections. Con la plantilla oficial tienes un blog funcionando en menos de una hora y puedes publicarlo gratis en Cloudflare.
Si estás leyendo este blog, estás viendo Astro en acción. Este sitio está construido con Astro y alojado en Cloudflare, y ha sido una de las mejores decisiones técnicas que he tomado. Antes usaba WordPress, y el cambio fue como pasar de un coche viejo a uno eléctrico: todo es más rápido, más limpio y pide menos mantenimiento.
Hoy te guío desde cero hasta un blog funcional. No hace falta ser experto, pero ayuda conocer lo básico de HTML y la línea de comandos.
¿Qué es Astro y por qué debería importarte?
Astro es un framework pensado para sitios donde lo importante es el contenido: blogs, documentación, portafolios, páginas de marketing. Su idea central es radical: cero JavaScript en el navegador por defecto.
Piensa en lo que implica. Muchos frameworks modernos mandan un buen paquete de JavaScript incluso para páginas que son texto estático. Astro renderiza todo a HTML y solo añade JavaScript donde un componente interactivo realmente lo necesita (lo que llaman “islands architecture”, o arquitectura de islas).
En la práctica, las páginas cargan muy rápido. En mi caso, el blog que tenía en WordPress tardaba unos 3,2 segundos en cargar y el mismo contenido en Astro ronda los 0,8 segundos (medición mía, con mi hosting y mi tema; tus números variarán). Y la velocidad se nota en la experiencia del lector y en las Core Web Vitals.
¿Por qué elegir Astro para tu blog?
Para sitios con mucho texto, Astro encaja bien por varias razones:
Notion vs Obsidian vs Bear (2026): ¿Qué app de notas elegir? →
- Rendimiento: sin JavaScript por defecto, es fácil acercarse a 95-100 en Performance de Lighthouse.
- Integración flexible: puedes usar React, Vue, Svelte o ninguno. Para la mayoría de blogs, la sintaxis nativa basta.
- Markdown de primera clase: las Content Collections validan el frontmatter con un esquema. Escribes en Markdown y Astro se encarga del resto.
- Buen terreno para SEO: el HTML estático es fácil de rastrear e indexar.
- Integraciones oficiales: Tailwind, sitemap, RSS y más se añaden con un comando.
Así queda frente a otras opciones habituales:
| Característica | Astro | Next.js | Hugo | WordPress |
|---|---|---|---|---|
| JavaScript al navegador | Mínimo | Bastante | Ninguno | Bastante |
| Curva de aprendizaje | Baja | Media-alta | Media | Baja |
| Velocidad de carga | Excelente | Buena | Excelente | Variable |
| Flexibilidad de UI | Alta | Alta | Limitada | Alta (plugins) |
| Costo de hosting | Gratis | Gratis a ~$20 | Gratis | $5-30/mes |
¿Cómo instalo Astro y creo mi primer proyecto?
Astro 6 es la línea estable actual (en mayo de 2026 ya iba por la 6.4). Su requisito principal: Node.js 22.12.0 o superior, porque se eliminó el soporte de Node 18 y 20, según la guía oficial de actualización a Astro v6. Compruébalo con:
node --version
Si tu versión es más antigua, actualiza desde nodejs.org o con un gestor como nvm. Después, crear el proyecto es directo:
npm create astro@latest mi-blog -- --template blog
cd mi-blog
npm run dev
El asistente te pregunta por dependencias y Git. Cuando termine, abre http://localhost:4321 y verás tu blog corriendo. La plantilla incluye:
- Página principal con la lista de artículos
- Página individual de cada artículo
- Estilos básicos fáciles de cambiar
- Content Collections ya configuradas
- Feed RSS
¿Cómo es la estructura de un proyecto Astro?
Una vez creado, el proyecto se parece a esto (los detalles varían un poco según la plantilla y la versión):
Mejores generadores de imágenes con IA 2026: Comparativa práctica →
mi-blog/
├── public/ # Archivos estáticos (imágenes, favicon)
├── src/
│ ├── components/ # Componentes reutilizables
│ ├── content/ # Tus artículos en Markdown
│ │ └── blog/
│ ├── layouts/ # Plantillas de página
│ ├── pages/ # Rutas del sitio
│ ├── styles/ # Estilos globales
│ └── content.config.ts # Definición de colecciones
├── astro.config.mjs # Configuración de Astro
└── package.json
Los archivos de src/pages/ se convierten en rutas automáticamente: about.astro pasa a ser /about. Los artículos viven en src/content/blog/ como archivos Markdown.
¿Cómo funcionan las Content Collections?
Las Content Collections son la forma que tiene Astro de tratar tu contenido como datos tipados. Desde Astro 6, todas usan la Content Layer API: la configuración está en src/content.config.ts y cada colección declara un loader que le dice a Astro de dónde sale el contenido, según la referencia de la API de loaders.
El loader glob() lee varios archivos (por ejemplo, todos los .md de una carpeta) y file() lee un único archivo JSON o YAML con muchas entradas. Un ejemplo mínimo para un blog:
import { defineCollection } from 'astro:content';
import { glob } from 'astro/loaders';
import { z } from 'astro/zod';
const blog = defineCollection({
loader: glob({ pattern: '**/*.md', base: './src/content/blog' }),
schema: z.object({
title: z.string(),
description: z.string(),
pubDate: z.coerce.date(),
updatedDate: z.coerce.date().optional(),
}),
});
export const collections = { blog };
El esquema es tu red de seguridad. Si olvidas el título o escribes mal una fecha, el build falla y te dice en qué archivo, en vez de publicar una página rota. Ese tipo de error se detecta mejor en tu máquina que en producción.
Si vienes de un proyecto antiguo con src/content/config.ts y colecciones sin loader, tendrás que migrarlo. Las colecciones “legacy” ya no se admiten automáticamente en Astro 6, y la guía de actualización explica cómo hacerlo paso a paso. Para saber cómo consultar las colecciones en tus páginas, mira la referencia del módulo astro:content, porque algunos detalles de renderizado cambian entre versiones.
Creando tu primer artículo
Crea el archivo src/content/blog/mi-primer-post.md:
---
title: "Mi primer artículo en Astro"
description: "Empezando mi aventura con Astro"
pubDate: 2026-11-02
---
Este es mi primer artículo. Astro hace que escribir
un blog sea muy sencillo.
## Por qué me cambié a Astro
La velocidad, la simplicidad y el control total
sobre mi contenido fueron las razones principales.
Mejores VPN 2026: Comparativa de Velocidad, Privacidad y Precio →
Lo que va entre los --- es el frontmatter, los metadatos del artículo. Debe cumplir el esquema que definiste. Lo de abajo es Markdown que Astro convierte en HTML.
¿Qué integraciones conviene añadir?
Para un blog serio necesitas unas pocas integraciones, y astro add las instala y edita la configuración por ti:
Tarifas de móvil baratas en 2026: cómo reducir tu factura telefónica a la mitad →
# Tailwind CSS para estilos
npx astro add tailwind
# Sitemap automático para SEO
npx astro add sitemap
# Adaptador de Cloudflare (solo si usas renderizado bajo demanda)
npx astro add cloudflare
Un detalle práctico: la integración de Tailwind ha cambiado con el tiempo (Tailwind 4 se integra mediante su plugin de Vite). Por eso conviene dejar que astro add tailwind escriba la configuración, en lugar de copiar un astro.config.mjs de un tutorial antiguo. Un archivo mínimo con sitemap y resaltado de código se ve así:
import { defineConfig } from 'astro/config';
import sitemap from '@astrojs/sitemap';
export default defineConfig({
site: 'https://tu-dominio.com',
integrations: [sitemap()],
markdown: {
shikiConfig: {
themes: { light: 'github-light', dark: 'github-dark' },
wrap: true,
},
},
});
Si lo único que tienes es un blog estático, no hace falta ni output ni adaptador: Astro genera HTML y lo dejas en dist. Y si en algún tutorial viejo ves output: 'hybrid', ignóralo: esa opción ya no existe y el modo por defecto cumple la misma función.
¿Cómo despliego mi blog Astro en Cloudflare?
Aquí hay un cambio importante respecto a lo que se enseñaba antes. Según la guía oficial de despliegue en Cloudflare, Cloudflare recomienda Workers para proyectos nuevos, y los proyectos que ya están en Pages se pueden migrar con su guía. Pages sigue funcionando para sitios existentes, pero yo empezaría con Workers si el proyecto es nuevo.
Para un sitio estático, el flujo es simple:
- Sube tu código a un repositorio de GitHub.
- Conéctalo en Cloudflare (Workers Builds o Pages) y usa
npm run buildcomo comando de compilación. - El resultado sale en la carpeta
dist, que es lo que se publica. - Cada
git pushdispara un despliegue nuevo.
Con Workers también puedes previsualizar en local con wrangler dev y publicar con npx wrangler deploy. Un paso concreto: el adaptador solo es necesario si usas renderizado bajo demanda; en ese caso npx astro add cloudflare crea también la configuración de Wrangler.
Dos trampas que he visto repetirse. La primera: el hosting necesita Node 22.12.0 o superior, así que fija la versión con un archivo .nvmrc o en la configuración del panel, o el build fallará con un error poco claro. La segunda: si ves errores de hidratación en el navegador, desactiva Auto Minify de Cloudflare, que la propia guía de Astro señala como causa posible. Dónde se aloja tu dominio y qué capas de caché activas puede variar, así que revisa el panel después del primer despliegue.
¿Qué hago para mantener el rendimiento desde el primer día?
Ahora que el blog corre, estos hábitos lo mantienen rápido:
Cómo sobrevivir a las búsquedas sin clic: estrategia GEO práctica para bloggers en 2026 →
- Usa el componente Image de Astro en lugar de etiquetas
<img>sueltas: optimiza a WebP y añade carga diferida. - Guarda las imágenes hero en WebP y por debajo de unos 200 KB.
- No instales paquetes de JavaScript innecesarios. Cada dependencia es JavaScript potencial en el navegador.
- Usa fuentes del sistema o
font-display: swappara evitar bloqueos de renderizado. - Revisa los encabezados de caché de los recursos estáticos.
Con esto es habitual superar los 95 puntos en Lighthouse sin esfuerzo extra, algo que WordPress solo logra con varios plugins de optimización.
Para cerrar
Astro sigue siendo una de las mejores herramientas para montar un blog: rinde bien, se trabaja a gusto y el ecosistema es sólido. La documentación está disponible en español en docs.astro.build.
Si estás harto de un WordPress lento, plugins con vulnerabilidades y cuotas mensuales de hosting, dale una oportunidad. Un fin de semana de configuración puede darte años de blog rápido y sin sobresaltos.
El siguiente paso: personaliza el diseño, escribe tus primeros cinco artículos y solicita Google AdSense cuando tengas contenido sólido. Tu blog está a un npm create astro@latest de distancia.
Este artículo es informativo. Las versiones y los requisitos de Astro y Cloudflare cambian con frecuencia; comprueba la documentación oficial antes de actualizar o desplegar. Última revisión: noviembre de 2026.
¿Qué es Astro?
Astro es un framework web para sitios centrados en contenido, como blogs y documentación. Genera HTML estático y solo envía JavaScript al navegador cuando un componente lo necesita, lo que da páginas muy rápidas.
¿Cuánto tiempo toma construir un blog con Astro?
La estructura básica se monta en unas pocas horas con la plantilla de blog oficial. Con un fin de semana puedes tener un blog funcional y publicado.
¿Necesito saber React o Vue para usar Astro?
No. Los componentes de Astro usan una sintaxis muy parecida a HTML. Puedes integrar React, Vue o Svelte si los necesitas, pero para un blog la sintaxis nativa es más que suficiente.
¿Astro es mejor que WordPress para un blog?
Depende. Astro gana en rendimiento, seguridad y costo, porque el resultado es estático y se aloja gratis. WordPress es mejor si quieres un editor visual y no tocar código. Si te sientes cómodo con Markdown y la terminal, Astro te da más control.
¿Qué versión de Node.js necesita Astro?
Astro 6 requiere Node.js 22.12.0 o superior, tanto en tu equipo como en el entorno de despliegue. Las versiones 18 y 20 ya no son compatibles. Comprueba tu versión con node --version.
¿Dónde puedo desplegar un sitio Astro gratis?
Cloudflare, Vercel y Netlify tienen planes gratuitos suficientes para un blog estático. En Cloudflare, la documentación actual de Astro recomienda Workers para proyectos nuevos, aunque los proyectos existentes en Pages siguen funcionando.
¿Qué es una Content Collection en Astro?
Es un conjunto de contenido (por ejemplo, tus entradas en Markdown) con un esquema validado. Defines la colección en src/content.config.ts con un loader como glob() y Astro comprueba que el frontmatter de cada archivo cumpla el esquema.
¿Qué hago si mi proyecto antiguo usa output: 'hybrid'?
Esa opción ya no existe en las versiones recientes. Deja el modo por defecto (estático) y marca con export const prerender = false solo las páginas que necesiten renderizado bajo demanda.
관련 글

Como crear un blog con Astro: guia completa paso a paso

Rendimiento web 2026: cómo hacer tu sitio más rápido

Android o iPhone en 2026: cuál comprar y si merece la pena cambiar de móvil

Notion vs Obsidian vs Bear (2026): ¿Qué app de notas elegir?

iPhone SE 4 Review 2026: ¿Vale la Pena Comprarlo?
