Skip to content

建立 2026-09-08 更新 2026-09-12

認識 Zensical

想專心寫文件,卻常卡在主題、搜尋與佈署?這個樣板幫你把瑣事先接好。

它基於 Zensical——由 Material for MkDocs 原班人馬打造的現代靜態網站產生器——複製下來就能用 Markdown 寫課程講義、專案文件與知識站,本機預覽與 GitHub Pages 自動上線都已就緒。

什麼是 Zensical?

Zensical 用 Markdown 寫內容,建置後產出靜態網站,適合課程講義、專案文件與知識庫。核心以 Rust 與 Python 打造,並提供接近 Material for MkDocs 的經典外觀,既有熟悉的寫作體驗,也有更快的建置速度。

為什麼選擇 Zensical?

  • 熟悉的外觀


    使用 classic 主題,沿用 Material 的導覽、搜尋與程式碼區塊體驗。

  • 專注寫作


    用 Markdown 撰寫,提示框、表格、公式與圖表都能直接使用。

  • 快速預覽


    本機一條指令即可即時預覽,改完立刻看到結果。

  • 自動上線


    推上 GitHub 後,CI 會自動建置並佈署到 GitHub Pages。

快速開始

安裝依賴並啟動本機預覽:

uv sync
uv run zensical serve

瀏覽器開啟 http://127.0.0.1:8000。建置靜態網站則使用:

uv run zensical build

輸出目錄為 site/

了解更多

想深入功能與設定,可參考 Zensical 官方文件。若想認識唯客學院,請看 關於我們