# Pasar las entradas de un blog de WordPress a MDX

> Claude Code sacó las entradas de la API de WordPress y las convirtió a MDX con metadatos: 367 entradas y 5 páginas en una sesión.

- **Tipo:** Caso de uso
- **Tema:** Programación
- **Herramientas:** Claude Code
- **Dificultad:** avanzada
- **Origen:** [pawlean.com](https://www.pawlean.com/posts/migrate-wordpress-to-mdx-claude-code)
- **En el directorio desde:** 11 de octubre de 2026
- **URL:** https://conqueia.com/caso/pasar-las-entradas-de-un-blog-de-wordpress-a-mdx

## A quién le sirve

Dueños de blogs en WordPress con muchas entradas que quieren pasarlas a una web hecha con archivos de texto (MDX); el método vale también para mover contenido entre otros sistemas.

## Qué hicieron

Pauline le dio a Claude Code, funcionando como agente en la terminal, un único objetivo: extraer todas las entradas de la API REST de su WordPress (la vía oficial para pedirle datos), convertirlas a MDX con metadatos al inicio (frontmatter) y guardarlas en carpetas por año. El agente gestionó los límites de peticiones de la API, pasó el HTML a Markdown y volvió a lanzar su script tras un error de codificación. Ella dice que dirigía y revisaba mientras hacía otras cosas.

## Cómo salió

Las 367 entradas y las 5 páginas pasaron a archivos MDX locales en una tarde, que ella cifra en unas 4 horas. Las entradas antiguas con etiquetas de imagen rotas bloqueaban la compilación y Claude las arregló con una expresión regular en todo el directorio.

## Conviene saber

Espera fallos de compilación por HTML antiguo y desordenado, como etiquetas de imagen rotas. Deja que el agente lea los errores y los corrija de golpe.

## Qué necesitas

- Claude Code con un plan de pago de Claude
- Tu WordPress con la API REST accesible, que es la vía oficial para pedirle datos y suele venir activada
- Un proyecto de destino, como una web que lea archivos MDX
- Una copia de seguridad completa de tu WordPress
- Una tarde libre para ir revisando

## Cómo hacerlo tú, paso a paso

1. Haz una copia de seguridad completa de tu WordPress.
2. Prepara el proyecto de destino y decide la estructura de carpetas, por ejemplo una carpeta por año.
3. Abre Claude Code en ese proyecto y pega el prompt de esta ficha con la dirección de tu web y los campos de metadatos que quieres.
4. Deja que gestione los límites de la API, convierta el HTML a Markdown, que es texto con marcas sencillas, y repita su programa si hay un error.
5. Cuando la compilación, que es el momento en que se genera la web, falle por HTML antiguo, como etiquetas de imagen rotas, pídele que lea los errores y los corrija todos de una vez.
6. Al terminar, pide el recuento de entradas y páginas y compáralo con tu WordPress.
7. Revisa a mano un puñado de entradas: imágenes, enlaces y formato.

## Pruébalo con Claude Code

```
Saca todas las entradas y páginas de mi web de WordPress en [dirección de la web] usando su API REST y convierte cada una en un archivo MDX con metadatos (título, fecha, slug, etiquetas, [otros campos]). Guárdalos en [ruta de la carpeta] de mi proyecto. Habrás terminado cuando me des el recuento de entradas y páginas convertidas y una lista de las que tuvieran problemas de formato que no hayas podido arreglar bien.
```

## Consejos

- Espera fallos de compilación por HTML antiguo y desordenado. Es lo normal.
- No borres tu WordPress hasta comprobar la web nueva entera, imágenes incluidas.
- Si cambian las direcciones de las entradas, prepara redirecciones para no perder visitas.

## Preguntas frecuentes

### ¿Se pierden las imágenes?

El caso solo cuenta que las etiquetas rotas bloquearon la compilación. Pide expresamente que las imágenes se descarguen y se enlacen bien, y compruébalo.

### ¿Necesito saber programar?

Tendrás que manejar una terminal, que es la ventana donde se escriben órdenes, y un proyecto web. Si no te manejas, pide ayuda para montar el proyecto de destino; la conversión la hace el agente.

## Fuentes

- [pawlean.com](https://www.pawlean.com/posts/migrate-wordpress-to-mdx-claude-code)
- [chandlernguyen.com](https://chandlernguyen.com/blog/2026/02/05/how-i-rebuilt-my-entire-blog-backend-in-4-days-with-claude-code/)

---

Fuente: conqueia.com/caso/pasar-las-entradas-de-un-blog-de-wordpress-a-mdx