CleanMyMac

把文章從 WordPress 搬出來：eleventy-import 的匯出方式

AI 畫的圖還真不錯

目錄

老實說，從 WordPress 轉移到其他系統，最痛苦的永遠不是選框架，而是「資料怎麼搬」。

這點大家應該都心有戚戚焉。

eleventy-import，終於可以把 WordPress 資料好好搬出來

11ty 的作者真的很懂這個痛點，直接自己寫了一個官方匯入工具：eleventy-import。

在真正遇到它之前，我其實也走過不少冤枉路。

一開始的想法很直覺：

👉 用 WordPress 外掛把文章匯出成 Markdown，再慢慢整理。

問題是——事情完全沒那麼單純。

為什麼一般 WordPress 匯出方式這麼痛苦？

之前試過幾個 WordPress 匯出外掛，產生出來的檔案大多有這些問題：

  • 夾雜大量 WordPress 專用標籤
  • 各種外掛留下來的 短代碼（shortcode）
  • XML / HTML 混在一起，格式不統一
  • 有的圖片是外掛語法，還有各種奇怪的包法

最麻煩的是：

👉 這些雜物沒有固定格式，根本沒辦法用一支 script 全部清乾淨

每篇文章都像在開盲盒，例外狀況多到讓人直接放棄。

於是這件事就這樣被擱著了。

官方出手：11ty 的 WordPress 轉移教學

直到有一天，在 11ty 官網亂逛時，看到這一頁：

👉 https://www.11ty.dev/docs/migrate/wordpress/

不只寫了完整教學，作者本人還拍了一支影片，標題是「Escape From WordPress」，整個就是用意非常明顯 😂

影片在這裡：

https://www.youtube.com/watch?v=WuH5QYCdh6w

看到這裡才發現：

👉 原來 11ty 早就把「從 WordPress 逃離」這件事想好了。

使用 eleventy-import 匯出 WordPress 文章

直接執行一行指令

使用方式非常暴力，也非常爽快：

npx @11ty/import wordpress https://your-site.com/

或者如果習慣 pnpm

pnpm dlx @11ty/import wordpress https://your-site.com/

第一次看到這行指令的反應是：

不是吧？就這樣？

沒了？

結果真的就 完成了，YA。

匯出後的目錄結構

eleventy-import 會直接幫你輸出成 11ty 最愛的格式：

your_project/
  assets/
    image1
    image2

  article1.md
  article2.md

幾個我覺得「非常關鍵」的點：

  • 每一篇文章都是 乾淨的 Markdown
  • 所有圖片自動整理進 assets/ 目錄
  • 文章內的圖片連結也已經幫你改好
  • 幾乎沒有 WordPress 遺毒

一句話總結：

👉 這個輸出結果，完全就是為了「直接丟進 11ty」而設計的。

下一步：選擇 11ty Starter

文章資料已經乾乾淨淨了，接下來就是選一個起始專案。

eleventy-base-blog

GitHub：

eleventy-base

優點：

  • 官方範例，結構清楚
  • 幾乎沒有多餘抽象
  • 非常適合「想自己慢慢加功能」的人
  • 好改、不綁架設計

缺點：

  • 功能極簡
  • SEO、樣式、搜尋、圖片優化都要自己補
  • 一開始看起來有點「什麼都沒有」

eleventy-excellent

網站：

eleventy-excellent

優點：

  • 幾乎什麼都幫你準備好了
  • 包含 SEO、圖片處理、效能最佳化
  • 設計完成度高，很快就能上線

缺點：

  • 設計與架構選擇比較多是「作者的想法」
  • 想大改時，需要先理解一整套設計哲學
  • 對我來說，反而有點太滿了

最後選擇

一開始其實是用 eleventy-excellent，因為真的很省事。

但實際調整一陣子後發現：

👉 一定會有一些地方「不是自己想要的方式」

而要改動那些地方，反而得先拆作者原本的設計。

最後決定回頭選擇 eleventy-base-blog：

從最簡單的開始，

需要什麼，再一個一個加。

啟動 11ty，驗收成果

把剛剛匯出的文章與 assets 目錄，放進：

content/blog/

然後啟動專案：

pnpm run start

打開瀏覽器，直接進：

http://localhost:8080/文章名稱/

你會看到一件很神奇的事：

  • 文章內容完整
  • 圖片全部正常
  • 但樣式幾乎全沒了

這一刻這是感動萬分！。

因為這代表：

👉 資料真的已經完全脫離 WordPress 了。

從這一刻起，是全新的開始

這樣的網站：

  • 快到不行，幾乎是秒開
  • 什麼功能都沒有
  • 但結構乾淨、可控、沒有包袱

這就是取捨啊。

WordPress 的功能真的很方便，

但當你選擇 11ty，簡單也不是壞事。

用效能、掌控感，交換即插即用的便利性。

接下來，才是真正有趣的地方。我想要網站愈來愈有趣，而不是愈來愈失去興趣。