[[Uebersicht|← Zurück zur Homepage]] # Machbarkeits-Check: MkDocs-Material-Migration > [!info] Kurzfassung > Prüfung, ob der Vault von **Obsidian Publish** auf eine selbst gebaute **MkDocs-Material**-Website (statisches HTML, GitHub Pages) umziehen kann. **Ergebnis: hoch machbar, geringes Risiko.** Der Großteil der Umwandlung ist über Plugins automatisierbar. ## 1. Ziel des Checks Feststellen, wie aufwändig und riskant ein Umzug von Obsidian Publish auf MkDocs Material für **dieses konkrete Setup** ist — auf Basis gemessener Vault-Daten, nicht Annahmen. ## 2. Bestandsaufnahme (gemessen am 2026-07-12) | Merkmal | Wert | Relevanz | |---|---|---| | Markdown-Dateien | 144 | überschaubar | | Wikilinks gesamt | 563 (in 103 Dateien) | müssen konvertiert werden | | davon mit Ordnerpfad `[[Ordner/Datei]]` | **0** | ✅ ideal – alle reine Dateinamen-Links | | Embeds `![[…]]` | 34 (in 24 Dateien) | Plugin nötig | | Callouts `> [!info]` | 8 (in 6 Dateien) | wenig, leicht | | Dataview-Blöcke | 1 | 1 Handgriff (manuell) | | Bilder/Attachments | 40 | mitkopieren | | Ordner mit Leerzeichen + Nummern | ja (`10 Hardware` …) | konfigurierbar | ## 3. Bewertung: Machbarkeit HOCH Der Vault ist ein fast idealer Kandidat. Entscheidend: Die **„reine Dateinamen-Links"-Konvention** (0 Ordnerpfade) lässt sich mit einem MkDocs-Plugin automatisch auflösen — Links funktionieren ohne manuelle Nacharbeit, unabhängig vom Ordner der Zieldatei. ## 4. Aufgaben nach Aufwand | Aufgabe | Aufwand | Lösung | |---|---|---| | `[[Wikilinks]]` → echte Links (563×) | gering | Plugin `mkdocs-roamlinks` / `mkdocs-ezlinks` (automatisch) | | `![[Bilder]]` einbetten (34×) | gering | dasselbe Plugin + `mkdocs-glightbox` | | Callouts umwandeln (8×) | minimal | Plugin `mkdocs-callouts` (automatisch) | | Navigation/Reihenfolge | gering | `01/02`-Nummern → `mkdocs-awesome-pages-plugin` | | Dataview-Block (1×) | 1 Handgriff | manuell ersetzen (Dataview existiert in MkDocs nicht) | | Auto-TOC-Hook (`Inhaltsverzeichnis`) | Entscheidung | Material hat eigene Navigation → TOC-Hook wird überflüssig | ## 5. Stolpersteine - **Hosting = GitHub Pages, NICHT Cloudflare Pages** — laut Projekt-Historie ist Cloudflare Pages gescheitert (404 trotz Build). Cloudflare bleibt nur DNS/Proxy davor. - **Umlaute/Sonderzeichen in Dateinamen** (`Datenschutzerklärung`, `Design – PDF-Extraktion`) → URL-Slugs sauber behandeln, sonst brechen einzelne Links. - **Parallelbetrieb möglich** — MkDocs erst unter Test-URL bauen, Obsidian Publish parallel laufen lassen, erst am Ende umschalten. Kein Risiko. ## 6. Fazit > **Migration klar machbar, geringes Risiko.** Links, Embeds und Callouts sind über Plugins automatisierbar. Realer Handaufwand: der 1 Dataview-Block + Feinschliff bei Navigation und Umlaut-Slugs. Einmaliger Einrichtungsaufwand geschätzt ein halber bis ganzer Tag. ## 7. Empfehlung / nächster Schritt Grünes Licht für ein detailliertes **Pflichtenheft MkDocs-Migration** mit konkreten Schritten (Setup, Plugin-Konfiguration, Deploy-Pipeline, Domain-Umzug, Abnahmekriterien). --- **Status:** Abgeschlossen **Version:** 1.0 **Zuletzt aktualisiert:** 2026-07-12 15:29 Uhr ### Änderungshistorie | Version | Datum | Uhrzeit | Änderung | |---|---|---|---| | 1.0 | 2026-07-12 | 15:29 | Erstfassung – Machbarkeits-Check auf Basis gemessener Vault-Daten | --- [[Impressum|Impressum]] | [[Datenschutzerklärung|Datenschutz]]