Los artículos viven en src/content/blog. Cada entrada es una carpeta con un archivo index.md o index.mdx.
Estructura de carpetas
src/content/blog/
├── mi-primer-articulo/
│ └── index.md
└── guia-mdx/
└── index.mdx
La carpeta define la URL del artículo:
/blog/mi-primer-articulo/blog/guia-mdx
Metadatos obligatorios
Todo el contenido debe ir precedido de frontmatter en YAML entre ---:
---
title: "Título del artículo"
description: "Resumen breve para listados y SEO."
date: "22 mar 2024"
draft: false
---
| Campo | Obligatorio | Tipo | Notas |
|---|---|---|---|
| title | Sí | string | Título visible y en RSS. |
| description | Sí | string | Resumen para listados y SEO. |
| date | Sí | string | Fecha parseable; agrupa el blog por año. |
| draft | No | boolean | Con draft: true no se publica. |
Escribir el contenido
Debajo del frontmatter escribe en Markdown o MDX:
---
title: "Por qué uso Astro"
description: "Rendimiento, simplicidad y menos JavaScript en el cliente."
date: "18 may 2026"
---
### Introducción
Astro genera HTML estático y solo hidrata lo que hace falta.
Buenas prácticas
- Usa títulos descriptivos y descripciones de una o dos frases.
- Revisa en local con
npm run devantes de desplegar. - Mantén
draft: truemientras el borrador no esté listo.
Listo: ya puedes publicar en tu blog.