Volver al blog

Cómo escribir un artículo en este blog

por Equipo

Este artículo existe para dos cosas: que el blog no arranque vacío —una lista sin entradas no deja juzgar el diseño— y que quien escriba la primera de verdad no tenga que adivinar el formato.

Bórralo cuando publiques la tuya.

Dónde van los archivos

Cada artículo es un archivo Markdown en apps/site/content/blog/<idioma>/. El nombre del archivo es la URL, así que conviene pensarlo: precios-que-no-asustan.md se publica en /es/blog/precios-que-no-asustan.

Una vez publicado, no lo renombres. Quien haya enlazado ese artículo se quedaría con un enlace roto, y los buscadores tardan meses en perdonarlo.

El encabezado

El bloque entre líneas de guiones, al principio del archivo:

  • title — obligatorio. Sin él, el artículo no se publica.
  • description — es lo que se lee en la lista y lo que enseña Google bajo el título. Si la dejas vacía, el buscador se inventa un trozo del texto, y casi nunca elige bien.
  • date — en formato 2026-09-26. Ordena la lista.
  • author — opcional.

Un idioma, una carpeta

Los artículos no se traducen solos. Cada idioma tiene su carpeta y puede tener artículos distintos: publicar en español algo que no existe en inglés es normal, y forzar la paridad llevaría a publicar a medias o a no publicar.

Qué se puede escribir

Markdown normal, con lo habitual de GitHub: negrita, cursiva, enlaces, listas, citas y tablas.

Las citas se ven así, y sirven para lo que sirven: dejar respirar un párrafo que importa.

También bloques de código:

const saludo = "hola";

Lo que no se puede es meter componentes. Es Markdown, no MDX, y es a propósito: para un artículo no hace falta, y evita toda una cadena de compilación extra.