---
title: "WordPress zu Astro migrieren: Wie ich über 50 Beiträge nach MDX umgezogen habe"
description: "Migriere WordPress Schritt für Schritt zu Astro und MDX: Exportiere deine Inhalte, konvertiere sie zu Markdown, bereinige das Frontmatter mit KI und behalte dein SEO mit 301-Redirects."
date: 2026-03-02
categories: ["web-development"]
tags: ["astro","wordpress","mdx"]
---

Ich hatte die Migration meiner WordPress-Site zu Astro und MDX monatelang vor mir hergeschoben. Ich hatte einen WordPress-Blog auf [wpdoze.com](https://www.wpdoze.com) mit einem Haufen alter Artikel, die ich auf [bitdoze.com](https://www.bitdoze.com) umziehen wollte – die läuft auf Astro mit MDX. Ich hatte mir ausgemalt, dass es schmerzhaft wird. Es stellte sich heraus, dass es halb so wild war, und ich möchte teilen, was ich gemacht habe, damit du dir den Trial-and-Error-Teil sparen kannst.

**Was sich geändert hat, seit ich das zuerst geschrieben habe (aktualisiert Nov. 2026)**

  

    
- Astro-Content-Collections nutzen jetzt Loader, die in src/content.config.ts definiert werden (Astro 5+ Content Layer, aktuell in Astro 7). Das alte Schema-only-Pattern in src/content/config.ts ist Legacy.
    
- Cloudflare Page Rules sind deprecated. Nutze stattdessen Redirect Rules (Single Redirects und Bulk Redirects). Sie haben Vorrang vor etwaigen verbliebenen Page Rules.
    
- Astro kann Bilder aus src/assets/ jetzt zur Build-Zeit encodieren (AVIF/WebP), sodass das Vorab-Konvertieren mit cwebp optional ist. Ich mache es weiterhin, um Git-Repos klein zu halten, aber du musst es nicht.
  

## Warum ich WordPress verlassen habe

WordPress funktioniert. Millionen von Sites laufen aus gutem Grund darauf. Aber meine Site bestand nur aus statischen Artikeln, und ich bezahlte trotzdem für Hosting, hütete Plugin-Updates und sah zu, wie die Ladezeiten schlechter wurden. Astro generiert schlichte HTML-Dateien, also laden Seiten sofort – ganz ohne Datenbank oder PHP. Hosting auf Cloudflare Pages kostet null Dollar. Und ich schreibe in MDX-Dateien in einem Git-Repo, statt mich mit dem Block-Editor herumzuschlagen. Das hat mir gereicht.

Wenn du neu bei Astro bist, habe ich eine Anleitung, [wie du einen kostenlosen Blog mit Astro und Cloudflare baust](/build-astro-blog-free/), und es gibt auch meine Liste der [besten Astro.js-Onlinekurse](/best-astrojs-online-courses/), falls du Video bevorzugst. Wenn du noch unentschlossen bist, geht mein [Astro-vs-WordPress-Vergleich zu Kosten und Betrieb](/astro-vs-wordpress/) tiefer auf die Monatsrechnung und die Wartungs-Trade-offs ein.

## Wie die Migration aussah

Hier ist die WordPress-zu-Astro-Migrationspipeline von Anfang bis Ende:

![WordPress-zu-Astro-Migrationspipeline: WP-Export, XML-zu-Markdown-Konvertierung, Codex-CLI-Bereinigung, Astro-Content-Collections, Build, Deploy auf Cloudflare Pages und 301-Redirects](@assets/images/26/03/wordpress-to-astro-migration-pipeline.svg)

Die Kurzfassung:

1. Alles aus WordPress exportiert (Beiträge, Seiten, Bilder)
2. Den XML-Export in Markdown-Dateien konvertiert
3. Codex CLI von OpenAI genutzt, um die langweiligen Teile zu automatisieren: Bildkonvertierung, Frontmatter-Formatierung, Reparieren von Bildreferenzen
4. Das Astro-Projekt gebaut und repariert, was kaputtging
5. Die alte Domain auf die neue umgeleitet

Ich gehe jeden Schritt durch.

### Was du zuerst brauchst

- WordPress-Adminzugang (Werkzeuge → Export) und die Site noch live; der Converter lädt die Bilder von deiner Live-Site herunter

- Node.js und npx auf deinem Rechner (wordpress-export-to-markdown v3.0.6 zum Zeitpunkt dieses Artikels)

- Ein Astro-Projekt mit MDX – oder du baust anschließend eins. Siehe meinen kostenlosen Astro-Blog-Guide

- Ein vollständiges Backup der WordPress-Site, bevor du irgendetwas anfasst

- Zugang zu den DNS-/CDN-Einstellungen der alten Domain (für die 301-Redirects später)

## Schritt 1: Exportiere deine WordPress-Inhalte

WordPress hat ein eingebautes Export-Tool. Geh in deinem Admin-Panel zu **Werkzeuge → Export** und exportiere **Alle Inhalte**. Du bekommst eine XML-Datei mit allen Beiträgen, Seiten, Kategorien, Tags und Bildreferenzen.

Ein paar Dinge, die du wissen solltest:

- Der Export enthält Bild-URLs, aber nicht die eigentlichen Dateien. Der Converter im nächsten Schritt lädt sie für dich herunter.
- Custom Post Types oder ACF-Felder brauchen eventuell Extra-Behandlung. Für einen normalen Blog reicht der Standard-Export.
- Sichere deine Site zuerst. Es gibt genug [kostenlose WordPress-Backup-Plugins](/best-free-wordpress-backup-plugins/), falls du noch keins hast. Wahrscheinlich wirst du das Backup nicht brauchen, aber du schläfst besser.

**Bevor du anfängst**

  Stell sicher, dass deine WordPress-Site während der Migration noch erreichbar ist. Der Markdown-Converter muss die Bilder von deiner Live-Site herunterladen.

**Prüfen**: Öffne die XML-Datei und vergewissere dich, dass sie ``-Einträge enthält, bevor du weitermachst. Ist die Datei leer oder abgeschnitten, hat der Export nicht funktioniert.

**Fehlerbild**: Exporte sehr großer Sites können im WordPress-Admin in ein Timeout laufen. Stirbt der Download auf halbem Weg, exportiere nach Inhaltstyp oder Datumsbereich statt alles auf einmal.

## Schritt 2: WordPress-XML zu Markdown konvertieren

Um WordPress zu Markdown zu konvertieren, ist [wordpress-export-to-markdown](https://github.com/lonekorean/wordpress-export-to-markdown) das richtige Tool. Es ist ein Node.js-CLI, das deinen XML-Export liest und Markdown-Dateien mit Frontmatter ausspuckt. Es lädt außerdem alle Bilder herunter.

### Installieren und ausführen

```bash
npx wordpress-export-to-markdown
```

Das Tool führt dich durch ein interaktives Setup: wo die XML-Datei liegt, wohin die Ausgabe soll, wie mit Bildern umgegangen wird. Ich habe Bilder gespeichert, Jahr-/Monatsordner übersprungen (ich wollte eine flache Struktur zum späteren Reorganisieren) und Entwürfe ausgeschlossen.

Das neueste Release zum Zeitpunkt dieses Artikels ist v3.0.6 (Juli 2026). Pinne es, wenn du reproduzierbare Läufe willst:

```bash
npx wordpress-export-to-markdown@3.0.6 \
  --frontmatter-fields=title,date,slug,categories,tags,coverImage,excerpt \
  --post-folders=false --date-folders=none
```

Das Flag `--frontmatter-fields` lässt den Converter Slug, Cover-Bild, Excerpt, Kategorien und Tags direkt ins Frontmatter schreiben. Das verkürzt den KI-Bereinigungsdurchlauf in Schritt 3 erheblich. Der Wizard berücksichtigt dieselben Optionen, falls du den interaktiven Weg bevorzugst. Flags sind für Scripting und Wiederholbarkeit da.

Wenn es fertig ist, hast du einen Ordner mit `.md`-Dateien und ein Verzeichnis mit allen Bildern.

**Prüfen**: `ls output/` (oder wohin du die Ausgabe auch gelenkt hast) zeigt `.md`-Dateien und ein gefülltes `images/`-Verzeichnis. Stichprobe: Prüfe im Frontmatter einer Datei, ob die angefragten Felder da sind.

### Wie die Ausgabe aussieht

Jeder Beitrag wird zu einer Markdown-Datei mit Frontmatter. Hast du den Converter mit Standardeinstellungen laufen lassen, bekommst du Titel und Datum. Mit `--frontmatter-fields` bekommst du deutlich mehr:

```markdown
---
title: "Your Post Title"
date: "2023-05-15"
slug: "your-post-slug"
categories: ["tutorials"]
tags: ["wordpress", "astro"]
coverImage: "images/your-image.png"
excerpt: "First paragraph of the post..."
---

Your post content here with images referenced like:
![your image description](images/your-image.png)
```

Was noch den KI-Durchlauf braucht: der Description-Text (die Meta-Description, nicht das Excerpt), Canonical-URLs, die auf die neue Domain zeigen, und Kategorie-Normalisierung, falls deine WordPress-Kategorien ein Chaos waren. Da kam Codex CLI ins Spiel.

## Schritt 3: Lass KI die Fleißarbeit erledigen

Dieser Schritt hat mir Stunden gespart. Ich habe [Codex CLI von OpenAI](https://github.com/openai/codex) genutzt, um die sich wiederholenden Datei-für-Datei-Änderungen zu erledigen, die ich bei über 50 Artikeln nicht per Hand machen wollte. Das Pattern ist das Entscheidende: Lass einen Coding-Agenten die Bulk-Edits machen und reviewe dann den Diff. Codex CLI, Claude Code oder ein ähnliches Tool funktioniert. Ich habe Codex genommen, weil ich es gerade offen hatte.

**Affiliate-Hinweis**

  Einige der folgenden Links sind Affiliate-Links. Ich empfehle nur Tools, die ich selbst nutze oder die zum hier beschriebenen Workflow passen.

Wenn du mehrere Coding-Agents nutzt, gibt dir [Agent Router](https://go.bitdoze.com/agentrouter) eine einzige Zugriffsschicht für Codex, Claude Code und Gemini CLI. Nicht nötig, aber praktisch, wenn du zwischen ihnen wechselst.

### Bilder zu WebP konvertieren

Der WordPress-Export hatte einen Mix aus PNG- und JPEG-Dateien, viele davon überdimensioniert. Es gibt zwei Wege, das zu handhaben.

### Weg A: Vorab-Konvertierung mit cwebp (was ich gemacht habe)

Konvertiere alles stapelweise zu WebP, bevor es ins Astro-Projekt kommt. Das hält die Source-Assets in Git klein – was zählt, wenn du Hunderte Bilder in ein Repo pushst:

```bash
# Converting all PNG/JPEG images to WebP format
for img in images/*.{png,jpg,jpeg}; do
  cwebp -q 80 "$img" -o "${img%.*}.webp"
done
```

WebP-Dateien sind bei vergleichbarer Qualität etwa 25–35 % kleiner als entsprechende JPEGs. Über einen ganzen Blog hinweg spart das viel Bandbreite. AVIF ist typischerweise noch kleiner, aber WebP hat breiteren Tooling-Support, und ich wollte mich während einer Migration nicht mit Edge Cases herumschlagen.

Nach diesem Schritt musst du außerdem die Bildreferenzen in den Markdown-Dateien aktualisieren (siehe nächster Abschnitt).

### Weg B: Astro beim Build encodieren lassen

Überspringe die manuelle Konvertierung komplett. Lege die originalen PNG-/JPEG-Dateien in `src/assets/`, nutze den `image()`-Frontmatter-Helper oder die ``-Komponente, und Astros Standard-Sharp-Image-Service encodiert sie zur Build-Zeit zu optimiertem AVIF/WebP.

Das ist das dokumentierte Astro-Verhalten mit dem Default-Image-Service. Es bedeutet auch, dass du den Schritt „Bildreferenzen aktualisieren" weiter unten überspringen kannst. Du behältst die originalen Dateinamen, und Astro übernimmt die Formatkonvertierung in der Ausgabe.

**Ehrliche Anmerkung**

  Ich habe Weg B auf dieser Site nicht End-to-End durchgespielt. Es ist das dokumentierte Verhalten der Astro-Image-Pipeline, kein persönlicher Test. Wenn dein Projekt eigene image.service-Optionen setzt, prüfe die zuerst.

### Bildreferenzen aktualisieren

Nur für Weg A nötig. Nach dem Konvertieren der Bilder zeigten alle Markdown-Dateien noch auf `.png`- und `.jpg`-Dateinamen. Codex CLI ist durch jede Datei gegangen und hat die Endungen getauscht:

```markdown
<!-- Before -->
![dashboard screenshot showing build metrics](images/dashboard-screenshot.png)

<!-- After -->
![dashboard screenshot showing build metrics](images/dashboard-screenshot.webp)
```

Wenn du Weg B genommen und Astro beim Build encodieren lässt, überspringe das komplett.

### Frontmatter für Astro formatieren

Meine Astro-Site nutzt ein Zod-validiertes Frontmatter-Schema. Wenn du den Converter in Schritt 2 mit `--frontmatter-fields` laufen ließest, ist die Hälfte davon schon erledigt. Übrig bleiben der Description-Text, die Canonical-URL und eventuelle Kategorie-Bereinigung:

```yaml
---
date: 2023-05-15T00:00:00Z
title: "Your Post Title"
description: "A brief description pulled from the first paragraph"
image: "../../assets/images/your-post/featured.webp"
categories: ["cms"]
authors: ["Dragos"]
tags: ["wordpress", "tutorials"]
canonical: "https://www.bitdoze.com/your-post-slug/"
---
```

### Bilder an den richtigen Ort verschieben

Astro optimiert Bilder am besten, wenn sie in `src/assets/` statt in `public/` liegen. Codex CLI hat die Bilder jedes Beitrags in die richtige Verzeichnisstruktur verschoben:

```
src/assets/images/
  └── post-slug/
      ├── featured.webp
      └── screenshot-1.webp
```

**Codex CLI war der eigentliche Zeitsparer**

  Ohne hätte ich allein für Bildkonvertierung, Referenz-Updates und Frontmatter-Formatierung einen ganzen Tag gebraucht. Codex hat das alles in Minuten erledigt. Ich habe nur die Ausgabe reviewed und den gelegentlichen Fehler korrigiert. Der ganze KI-Durchlauf sind Minuten an Tool-Zeit. Keine bezahlte API nötig – über das Coding-Agent-Abo hinaus, das du ohnehin hast.

## Schritt 4: Richte deine Astro-Content-Collection ein

Wenn du noch keine Astro-Site hast, richte zuerst eine ein. Mein [kostenloser Astro-Blog-Guide](/build-astro-blog-free/) deckt das ab.

Astro-Content-Collections definieren, welche Felder deine Beiträge brauchen, und validieren sie zur Build-Zeit. Seit Astro 5 (der Content Layer) leben Collections in **`src/content.config.ts`** und brauchen einen Loader. Projekte vor Astro 5 nutzten `src/content/config.ts` ohne Loader. Wenn du in Tutorials beide Patterns siehst, liegt es daran. Die Config unten ist für Content Collections der Astro-7.x-Ära geschrieben (diese Site läuft auf Astro 7.4).

```typescript
// src/content.config.ts
import { defineCollection } from "astro:content";
import { glob } from "astro/loaders";
import { z } from "astro/zod";

const posts = defineCollection({
  loader: glob({ pattern: "**/*.{md,mdx}", base: "./src/content/posts" }),
  schema: ({ image }) =>
    z.object({
      date: z.coerce.date(),
      title: z.string(),
      description: z.string().optional(),
      image: image().optional(),
      categories: z.array(z.string()).optional(),
      authors: z.array(z.string()).optional(),
      tags: z.array(z.string()).optional(),
      canonical: z.string().optional(),
    }),
});

export const collections = { posts };
```

Der Schema-Kontext `()` gibt dir den `image()`-Helper für optimierte Bildreferenzen im Frontmatter. `z.coerce.date()` behandelt die Tatsache, dass Frontmatter-Daten über den Glob-Loader als Strings ankommen.

Lege deine konvertierten MDX-Dateien in `src/content/posts/` und die Bilder in `src/assets/images/`.

## Schritt 5: Builden und reparieren, was kaputtgeht

Führe deinen Astro-Build aus, um zu sehen, was kaputt ist:

```bash
bun run build
```

Worüber ich gestolpert bin:

- Kaputte Bildpfade, bei denen die Referenz in der MDX-Datei nicht zum tatsächlichen Dateiort passte
- Ungültiges Frontmatter, das Astros Zod-Validierung abgelehnt hat (sie sagt dir genau, welches Feld in welcher Datei – praktisch)
- HTML aus WordPress, das MDX nicht mochte – meist ungeschlossene Tags und nicht escapte Sonderzeichen
- Fehlende Komponenten-Imports am Anfang von MDX-Dateien

Noch eins: Veraltete `node_modules` nach einem Node- oder Bun-Versionswechsel verursachen Phantom-Build-Fehler. Installiere die Dependencies neu, bevor du den Build selbst debuggst.

Ich habe den Build nach jedem Änderungsbatch laufen lassen – ging etwas kaputt, wusste ich, was ich gerade angefasst hatte. Codex CLI half auch hier, indem es die Build-Fehlerausgabe las und die Probleme automatisch behob.

## Schritt 6: Deployen und umleiten

Wenn der Build durchläuft, deploye. Ich nutze Cloudflare Pages und habe einen [Guide zum Deployen von Astro auf Cloudflare](/deploy-astrojs-cloudflare/) geschrieben, falls das auch dein Setup ist. Du kannst [Astro auch auf einem VPS deployen](/deploy-astro-on-vps/) – mit einem Budget-VPS wie [Hetzner](https://go.bitdoze.com/hetzner), wenn du deinen eigenen Server verwalten willst – oder [Astro auf Bunny.net deployen](/deploy-astro-bunny-net/) mit [Bunny.net](https://go.bitdoze.com/bunny), wenn du ein Edge-CDN vor den statischen Dateien willst.

### Domain-Redirects einrichten

Das letzte Stück: Leite deine alte Domain um. Ich habe `wpdoze.com` auf `bitdoze.com` zeigen lassen. Cloudflare Page Rules sind inzwischen deprecated. Nutze stattdessen **Redirect Rules**. Moderne Rules haben Vorrang vor alten Page Rules, die du eventuell noch herumliegen hast.

So sieht ein Single Redirect im Cloudflare-Dashboard aus (Rules → Redirect Rules → Create rule → Template „Redirect from domain to domain"):

```
Single Redirect (wildcard pattern)
  When: Hostname equals wpdoze.com
  Then: Dynamic redirect to https://www.bitdoze.com/${http.request.uri.path}, 301
```

Dieser Wildcard funktioniert, wenn die URL-Formen zwischen alter und neuer Site übereinstimmen. Hat deine WordPress-Site Datums-Permalinks genutzt (`/2023/05/slug/`) und deine Astro-Site flache Slugs (`/slug/`), landet die Pauschalregel alte Deep Links auf 404s. In dem Fall brauchst du ein Per-URL-Mapping.

![Redirect-Formen im Vergleich: Wildcard-Single-Redirect, wenn Pfade übereinstimmen, versus Per-URL-Bulk-Redirects, wenn Datums-Permalinks zu flachen Slugs werden](@assets/images/26/03/wordpress-to-astro-redirect-shapes.svg)

Für Per-URL-Redirects: [Exportiere deine WordPress-Beitrags-URLs und -Titel](/export-wordpress-post-urls-titles/) aus der XML oder einem Crawl, baue eine CSV, die alte Pfade auf neue mappt, und lade sie zu **Cloudflare Bulk Redirects** hoch (CSV-Upload). Auf Cloudflare Pages funktioniert auch eine `_redirects`-Datei in deinem Deploy-Output.

**Überspringe die Redirects nicht**

  301-Redirects sagen Suchmaschinen, dass deine Inhalte permanent umgezogen sind. Ohne sie verlierst du den SEO-Wert, den deine alte Domain aufgebaut hat, und Besucher, die auf alte Bookmarks oder Suchergebnisse klicken, landen auf einer toten Seite. Teste den Wildcard gegen 5–10 echte alte URLs, bevor du irgendetwas abschaltest.

### Den Umzug verifizieren

Geh nicht davon aus, dass die Redirects funktionieren. Prüfe sie:

```bash
# 1. Redirects answer 301 (not 302, not 200)
curl -sI https://wpdoze.com/some-old-slug/ | grep -iE '^(HTTP|location)'

# 2. Sitemap present on the new site
curl -s https://www.bitdoze.com/sitemap-index.xml | head

# 3. Spot-check migrated posts render with images
curl -s https://www.bitdoze.com/your-post-slug/ | grep -c '<img'

# 4. Old WP uploads still resolve (deep-linked from the web)
curl -sI https://wpdoze.com/wp-content/uploads/2023/05/some-image.png | grep -iE '^(HTTP|location)'
```

Wie „kaputt" aussieht: Ein 302 statt eines 301 gibt keinen SEO-Wert weiter. Prüfe die Statuszeile, nicht nur, dass ein Redirect passiert. Eine Null vom `/feed/-URLs, Attachment-Seiten und Archiv-Paginierung (/page/2/) um oder lass sie bewusst 404en. Sie werden oft deep-verlinkt und sterben in Migrationen still.

- Senke den DNS-TTL der alten Domain einen Tag vor dem Wechsel, damit ein Rollback schnell geht, falls etwas schiefgeht.

Die WordPress-Site ist dein Rollback. Durch die Migration wird nichts zerstört. Geht die neue Site kaputt, zeigst du den DNS zurück. Schalte WordPress nicht ab, bevor der Link-Crawler sauber zurückkommt. Wissenswert auch: Null Hosting auf dem Cloudflare-Pages-Free-Tier bedeutet null *Hosting*, nicht null alles. Domain-Verlängerungen und Drittanbieter-Services kosten weiter Geld (mehr dazu im Fazit-Abschnitt).

## Nach der Migration

Sobald deine Inhalte drüben sind, lohnt sich einiges:

- Ich habe einen Guide zu [Astro-SSG-Build-Optimierung](/astro-ssg-build-optimization/) geschrieben, weil große Sites langsam zu builden werden können. Lesenswert, wenn du mehr als eine Handvoll Beiträge hast. Es gibt auch [Astro-7-Build-Speed-Benchmarks](/astro-7-faster-builds/), wenn du sehen willst, was dir die neueste Major-Version bringt.
- Wenn du auf Node.js bist, hat der [Wechsel zu Bun](/migrate-astro-bun/) meine Build-Zeiten spürbar verkürzt.
- Irgendwann willst du wahrscheinlich ein [Kontaktformular](/add-contact-form-astro/).
- Für Analytics nutze ich Plausible, geproxied durch Cloudflare Workers. Ich habe aufgeschrieben, [wie man das einrichtet](/astro-plausible-cloudflare-workers/).
- Wenn rohes MDX nicht deins ist und du eine CMS-UI willst, hier sind die [Headless-CMS-Optionen für Astro](/best-headless-cms-for-astro/), die sich lohnen.

## Häufig gestellte Fragen

**Wie lange dauert die ganze Migration?**

  Hängt davon ab, wie viele Beiträge du hast. Meine Site hatte rund 50 Artikel, und das Ganze dauerte etwa einen Tag. Die meiste Zeit ging fürs Reviewen dessen drauf, was Codex CLI produziert hat, und fürs Fixen von Edge Cases. Der eigentliche Export und die Konvertierung waren vielleicht eine Stunde.

**Muss ich TypeScript können, um Astro zu nutzen?**

  Nein. Schlichtes JavaScript funktioniert in Astro-Komponenten prima. TypeScript ist optional, ich empfehle es aber für Content-Collection-Schemas, weil es Frontmatter-Fehler zur Build-Zeit abfängt. Die Zod-Schema-Definitionen sind auch lesbar, wenn TypeScript neu für dich ist.

**Was ist mit WordPress-Kommentaren?**

  Astro ist ein Static Site Generator, es gibt also kein eingebautes Kommentarsystem. Du kannst Giscus (nutzt GitHub Discussions), Disqus oder Hyvor Talk anflanschen. Ich persönlich habe Kommentare ganz gestrichen. Die meisten waren Spam.

**Verliere ich meine SEO-Rankings?**

  Mit sauberen 301-Redirects sollten die Rankings übernommen werden. Ich sah etwa zwei Wochen einen kleinen Dip, während Google alles neu verarbeitete, dann erholte es sich. Die schnelleren Ladezeiten durch Astro halfen meinen Rankings danach. Bei Domain-Umzügen reiche eine Change of Address in der Google Search Console ein und submitte deine neue Sitemap. Ich nutze [SEO Gets, um Search-Console- und GA4-Daten zu tracken](/seo-gets-tool/), damit ich die Erholung an einem Ort beobachten kann.

**Kann ich diesen Prozess für eine WooCommerce-Site nutzen?**

  Für die Inhaltsteile (Blogbeiträge, Seiten) ja. Aber wenn du einen WooCommerce-Shop mit Produkten, Warenkorb und Checkout hast, ersetzt Astro allein das nicht. Du bräuchtest eine Headless-Commerce-Schicht wie Snipcart oder Shopifys Storefront API neben Astro.

**Was, wenn meine Beiträge WordPress-Shortcodes nutzen?**

  Shortcodes werden nicht konvertiert. Der Markdown-Exporter kippt sie als reinen Text aus. Du musst sie durch MDX-Komponenten ersetzen oder schlicht entfernen. Ich habe Codex CLI genutzt, um alle Shortcodes in meinen Dateien zu finden und die gängigen in MDX-Äquivalente umzuwandeln. YouTube-Embeds sind der häufigste Überrest. Hier steht, [wie man YouTube-Videos in Astro einbettet](/add-youtube-videos-astro-blog/).

**Meine URLs haben ihre Form geändert (Datums-Permalinks zu flachen Slugs). Was nun?**

  Ein pauschaler Domain-301 funktioniert nur, wenn die Pfadformen übereinstimmen. Nutzte WordPress Datums-Permalinks wie /2023/05/slug/ und deine Astro-Site flache Slugs wie /slug/, laufen alte Deep Links auf 404. Baue ein Per-URL-Redirect-Mapping: [Exportiere deine WordPress-Beitrags-URLs und -Titel](/export-wordpress-post-urls-titles/), erstelle eine CSV mit altem Pfad auf neuen Pfad und lade sie zu Cloudflare Bulk Redirects hoch (oder nutze eine _redirects-Datei auf Cloudflare Pages). Teste 5–10 echte alte URLs vor dem Livegang.

**Was ist mit WordPress-Feeds und Attachment-URLs?**

  WordPress-Feeds (/feed/), Attachment-Seiten und Archiv-Paginierung (/page/2/) werden oft deep-verlinkt und sterben in Migrationen still. Leite /feed/ auf deinen neuen Astro-RSS-Feed um (@astrojs/rss generiert einen). Leite Attachment-URLs auf ihren übergeordneten Beitrag um, oder lass sie bewusst 404en. Triff die Wahl nur bewusst, statt sie drei Monate später in deinen 404-Logs zu entdecken.

## Fazit

Der Umzug von WordPress zu Astro kostete einen Tag konzentrierter Arbeit, und ich bin froh, es gemacht zu haben. Meine Site lädt schneller, die Hosting-Kosten gingen von einer bezahlten WordPress-Hosting-Rechnung auf null auf dem Cloudflare-Pages-Free-Tier, und das Schreiben in MDX-Dateien schlägt den WordPress-Editor für meinen Workflow. Zur Klarstellung bei den Kosten: „Null" heißt null Hosting. Du zahlst weiterhin für Domain-Verlängerung und Drittanbieter-Services. In meinem Fall Plausible, geproxied durch Cloudflare Workers ([wie ich das eingerichtet habe](/astro-plausible-cloudflare-workers/)).

Die Tools, die es praktikabel machten: [wordpress-export-to-markdown](https://github.com/lonekorean/wordpress-export-to-markdown) für die erste Konvertierung und Codex CLI für die ganze Datei-für-Datei-Neuformatierung, die ich nicht per Hand machen wollte. Astros Content-Collections banden alles zusammen mit typsicherer Validierung, die Fehler zur Build-Zeit abfing.

Wenn du die Migration deiner WordPress-Site zu Astro vor dir herschiebst: Fang einfach mit einer Handvoll Beiträge an und schau, wie es läuft. Der Prozess ist mehr mechanisch als kreativ, und das Tooling erledigt das Meiste.