版本更新與路線圖
Zensical 目前還在 0.0.x 階段，幾乎每週都有新版本。這一頁整理近期值得注意的新功能與官方公布的發展方向，資料來源是 GitHub Releases、官方 Roadmap 與 Upcoming changes。
整理時間
本頁內容整理至 2026-10-01，當時 PyPI 上的最新版本是 0.0.67。之後的版本請查 GitHub Releases。
近期版本的重點
| 版本 | 日期 | 重點 |
|---|---|---|
| 0.0.67 | 2026-09-30 | 新增原生 social 外掛（社群分享卡片），見 社群分享卡片；新增 llmstxt（產生 llms.txt 與頁面的 Markdown 副本，搭配 content.action.copy 顯示「Copy as Markdown」按鈕）、exclude（依路徑樣式排除檔案）、gh-admonitions（GitHub 風格 alert，等同啟用 pymdownx.quotes 的 callouts）外掛 |
| 0.0.66 | 2026-09-28 | 支援 mkdocs-autoapi 與 mkdocs-api-autonav，可自動掃描 Python 原始碼、產生 API 參考頁並加入導覽，底層仍是 mkdocstrings；修正原始 HTML 裡的響應式圖片網址、sitemap 缺頁、TOML 設定的自訂 InlineHilite 格式器 |
| 0.0.65 | 2026-09-24 | 新增原生 rss 外掛，可產生 RSS 2.0 與 JSON Feed 1.1；支援 mkdocstrings 的 backlinks（在快取建置中仍保持正確）與 enable_inventory；支援 mike 的 version_selector；支援更多 macros、autorefs 設定 |
| 0.0.64 | 2026-09-22 | 新增原生 blog 外掛，見 部落格 |
| 0.0.63 | 2026-09-19 | 含 Snippets 的頁面在預覽時，來源檔案改變會重新建置；產出網站排除隱藏檔與隱藏資料夾；修正預覽網站根目錄的重新導向，並在保留自訂錯誤頁的前提下回傳正確的 404；修正「只有 index 頁的區段」出現空子選單；新增 60 個圖示（Lucide、Octicons、Simple Icons） |
| 0.0.62 | 2026-09-13 | 支援 mkdocs-callouts 外掛（Obsidian 風格 callouts）；錨點連結會先展開被收合的 details、頁簽與程式碼註解，再捲動到目標，巢狀組合也適用 |
| 0.0.61 | 2026-09-11 | 完整的重新導向支援：頁面與錨點重新導向、解析重新導向鏈、拒絕循環，見 重新導向 |
| 0.0.60 | 2026-09-08 | 直接支援 table-reader 外掛（不必經過 macros）；修正導覽修剪（navigation pruning）與替代連結；新增 51 個圖示 |
| 0.0.59 | 2026-09-03 | 修正導覽標題優先順序、Windows 的 custom_dir 路徑、minify 外掛破壞圖示的問題 |
| 0.0.58 | 2026-09-02 | 一次新增 tags、redirects、meta、minify、awesome-nav、literate-nav 外掛的原生替代實作；預覽支援安全的 WebSocket |
更早之前值得一提的功能
| 版本 | 日期 | 功能 |
|---|---|---|
| 0.0.53 | 2026-08-04 | 支援 strict 設定選項，見 連結驗證 |
| 0.0.52 | 2026-07-30 | 搜尋新增 CJK（中日韓）語言支援 |
| 0.0.40 | 2026-05-04 | 支援 macros 外掛 |
| 0.0.33 | 2026-04-14 | zensical new 產生的 zensical.toml 加入預設的 Markdown 擴充 |
| 0.0.22 | 2026-02-11 | 支援 autorefs 外掛 |
| 0.0.16 | 2026-01-15 | 提示框圖示可以使用任意的類型名稱（theme.icon.admonition） |
| 0.0.15 | 2025-12-24 | 搜尋支援模糊比對（fuzzy search） |
用中文搜尋
如果你的網站是中文內容，建議把 Zensical 升級到 0.0.52 以上，才能受惠於搜尋的 CJK 支援，見 站內搜尋。
官方 Roadmap
官方說明 Roadmap 只代表方向，不承諾日期或實作順序。
現在已可使用
| 功能 | 說明 |
|---|---|
| MkDocs blog 外掛替代 | 用 Zensical 發佈部落格，見 部落格 |
| MkDocs social 外掛替代 | 用 Zensical 產生社群分享卡片，見 社群分享卡片 |
| MkDocs exclude 外掛替代 | 依路徑樣式從網站建置中排除指定的檔案 |
| MkDocs rss 外掛替代 | 產生 RSS 2.0 與 JSON Feed 1.1 |
| Directives（Spark 搶先體驗） | 用共用的 Markdown 來源組出不同版本的文件（條件內容、變數、檔案引用）。只提供給 Zensical Spark 會員，見 從 MkDocs 遷移 |
開發中
| 功能 | 說明 |
|---|---|
MkDocs optimize 外掛替代 |
在建置過程中最佳化媒體檔案 |
| Zensical Markdown（Spark 優先） | 以 Rust 重新實作 Python Markdown，追求更快的建置與更容易擴充。官方測試的解析器速度超過 Python Markdown 的 50 倍，也計畫提供命令列與 CI 使用的格式化工具與檢查工具，以及 CommonMark 相容 |
接下來
| 功能 | 說明 |
|---|---|
| 給 AI 代理的專案模型 | 讓代理可以透過 CLI 取得專案模型 |
| 遷移就緒評估 | 遷移到 Zensical 之前先評估專案 |
| Python 的模組 API（Spark 優先） | 用 Python 撰寫模組來擴充 Zensical |
長期方向
- 模組系統：在發佈流程加入自訂步驟、可安裝與分享的模組套件。
- 設定：零設定模式、資料夾層級的設定、環境變數、可重複使用的預設組合（presets）。
- API 文件：原生的 OpenAPI 與原始碼參考文件（目前可用
mkdocstrings）。 - 內容重複使用：內容目錄（catalog）、條件內容、變數替換、參數化引用、可重複使用的主題。
- AI 工作流程：給使用者與 AI 代理都適用的文件。
- 遷移與匯入：把貼上的富文字、HTML、表格資料轉成 Markdown。
2026 年 11 月 5 日將發生的事
官方公布在 2026-11-05：
- Zensical 0.1.0 發佈，結束
0.0.x的 alpha 系列，開始穩定的發行線。之後仍會留在0.x，等公開 API 長期穩定後才會正式標示1.0。公開 API 若必須變動，官方承諾提供明確的遷移路徑。 - Zensical Studio 推出 Free、Pro、Team 三種版本（Studio 是閉源的編輯器應用程式；Studio 的編輯器整合是開源的）。在此之前 Studio 的公開 beta 完全免費，見 格式檢查及自動補齊。
- Zensical Spark Community 開放給個人加入。
- Material for MkDocs 的生命週期終點（EOL）延長六個月，關鍵維護持續到 2027-05-05。
官方也保證：Zensical 與所有開源專案都會維持 MIT 授權、永久免費，內容永遠是可攜的原始檔，不對網站、讀者、建置、發佈或佈署收費。
怎麼追蹤更新
- 看 GitHub Releases，每個版本都有摘要與變更清單。
- 查 PyPI 上的最新版本：
pip index versions zensical，或uv pip show zensical。 - 升級方式見 基本操作指令裡的「升級 Zensical」。
- 升級後若輸出異常，先執行
zensical build --clean。