Ingeniería
Cómo construimos el blog de Porta
Por qué el blog de Porta usa MDX en el repositorio, un registro tipado y páginas estáticas, y qué cuidamos en SEO: hreflang, lastmod, RSS y datos estructurados.
26 de octubre de 2026 · 5 min de lectura
Queríamos un blog que respondiera preguntas reales de quien busca casa en Costa Rica y que, además, ayudara a que Porta aparezca cuando alguien pregunta en Google o en un asistente de IA. Eso nos dejó tres requisitos: que cada artículo llegue completo en el HTML del servidor, que exista en español y en inglés sin señales contradictorias para los buscadores, y que publicar un artículo sea tan revisable como cualquier cambio de código.
Contenido en el repositorio y no en un CMS
Evaluamos un CMS headless (Sanity, Payload, Contentful) frente a archivos en el propio repositorio. Somos un equipo pequeño y hoy quienes escriben son las mismas personas que programan, así que un CMS sumaba un servicio más, autenticación, webhooks y una vista previa que mantener, para un número de editores que hoy es cero.
Elegimos MDX con @next/mdx, el camino que documenta Next.js para el App Router. Cada artículo vive en src/content/<sección>/<slug>/<idioma>.mdx, de modo que la versión en español y su traducción quedan en la misma carpeta y una revisión de código muestra las dos juntas. Si un día escriben personas fuera del equipo técnico, el contenido ya está separado y migrarlo a un CMS es mover archivos.
Un registro para todo lo que no es prosa
El MDX contiene solo el texto. Todo lo demás vive en un registro tipado en TypeScript: el slug, la sección, la categoría, las fechas de publicación y de actualización, los idiomas disponibles, el título y la descripción de cada idioma, los artículos relacionados y el llamado a la acción. Es el mismo patrón que ya usaba nuestro centro de ayuda.
La razón es práctica. El sitemap, el feed RSS, los índices y los metadatos de cada página necesitan saber qué artículos existen sin compilar ninguno. Un archivo de TypeScript sin dependencias de cliente se puede importar desde cualquiera de esos lugares. Unas pruebas comparan el registro con la carpeta de contenido en las dos direcciones, así que un artículo sin registrar o un registro sin artículo hacen fallar las pruebas de integración continua antes de llegar a producción.
El servidor arma la página completa
Cada artículo se renderiza en el servidor y llega completo en el HTML, igual para personas y para buscadores; el cuerpo es un Server Component, así que casi no suma JavaScript al navegador. El registro fija qué slugs existen en cada idioma: un slug que no está registrado en un idioma devuelve 404 en lugar de mostrar el texto de otro idioma bajo la URL equivocada.
Las rutas declaran generateStaticParams y dynamicParams = false, y cada artículo sale del build como HTML estático que se regenera cada hora. No fue gratis: el layout común del sitio leía la sesión del usuario en el servidor, y una sola lectura de la petición en ese layout hace que todas las páginas debajo de él se rendericen en cada visita. Movimos la sesión y el aviso de mantenimiento al navegador, y desde entonces el blog, el centro de ayuda y las páginas de producto se sirven desde la caché de Next en pocos milisegundos.
El índice del artículo y el tiempo de lectura no se escriben a mano. Se derivan del propio MDX: los encabezados de segundo nivel forman el índice, con los mismos identificadores que les asigna rehype-slug en el HTML, porque ambos usan github-slugger sobre el mismo texto. El tiempo de lectura cuenta las palabras a 200 por minuto, la misma cifra que usa el centro de ayuda. Ya nos pasó que tiempos de lectura escritos a mano terminaron diciendo cosas distintas en lugares distintos, y no queríamos repetirlo.
SEO: lo que hacemos y lo que evitamos a propósito
- Datos estructurados. Cada guía publica
BlogPostingy cada nota técnicaTechArticle, con fechas, idioma, imagen y unBreadcrumbList. El autor es la organización y no una persona inventada: la guía de Google pide que la autoría sea real, y preferimos una firma honesta del equipo. - hreflang según el registro. Las páginas estáticas del sitio declaran siempre español, inglés y
x-default. Un artículo puede existir en un solo idioma, así que sus alternativas se calculan desde el registro y nunca apuntan a una traducción que no existe. lastmodhonesto. El sitemap de artículos usa la fecha de la última modificación del contenido, no la hora del build. Google ignoralastmodcuando detecta que no es confiable, y ese descuento afecta a todo el sitio, incluidas las fechas reales de las publicaciones de propiedades.- Categorías sin contenido delgado. Una categoría queda en
noindex, followy fuera del sitemap hasta reunir cinco artículos. Las dos decisiones leen la misma función, de modo que nunca enviamos al buscador una URL que pide no ser indexada. - Imágenes para redes generadas por artículo. Cada artículo tiene su tarjeta de 1200×630 hecha con
ImageResponseen el servidor, con la misma fuente Figtree que usan nuestras piezas para redes sociales. - RSS por idioma. Cada sección publica su feed en
/es/<sección>/rss.xmly/en/<sección>/rss.xml, enlazado desde el<head>de los índices, las categorías y los artículos.
Lo que todavía no hicimos
No hay páginas de autor porque hoy firmamos como equipo. Tampoco hay paginación: con decenas de artículos, una sola página por índice es más útil que varias casi vacías. Ambas cosas tienen lugar en el diseño y las agregaremos cuando el contenido lo justifique.
Si te interesa cómo resolvemos otros problemas, como mostrar precios en dos monedas sin que cambien entre una pantalla y otra, seguí este blog o suscribite al feed.
Elaborado por el equipo de Porta con apoyo de herramientas de inteligencia artificial y contrastado con las fuentes citadas en el texto. Si encontrás un dato desactualizado, escribinos desde el Centro de ayuda.
Artículos relacionados
Ingeniería
Precios en colones y dólares sin sorpresas
Cómo Porta muestra precios en colones o dólares al tipo de cambio del BCCR: conversión en el servidor, filtros entre monedas y un primer render sin adivinar.
26 de octubre de 2026 · 5 min de lectura