原本我都是用 Chirpy,但有的格式和 Obsidian 無法相容(連最基礎的 KaTeX 都沒辦法!),所以只好找新的方案。很幸運找到這個叫做 Quartz 的開源專案可以完全支援 Obsidian 的 Markdown 風格!

這專案還是由 Obsidian 官方贊助的, 盡管他們自己有功能的官方付費方案 。

剛點進去就有安裝步驟,照著安裝就好了。你可以看它在本地端的樣子

npx quartz build --serve

記得 content 內要有 index 檔案!

建議先新增一個 Template。

---
title: Example Title
draft: false
tags:
  - example-tag
date: 2025-12-10
---

有興趣可以參考官網看更詳細的教學。

  1. Writing content in Quartz
  2. Configure Quartz’s behaviour
  3. Change Quartz’s layout
  4. Build and preview Quartz
  5. Sync your changes with GitHub
  6. Host Quartz online

常用指令

npx quartz sync # Push changes to remote repo
npx quartz build --serve

常用檔案

  • quartz.config.ts:調整整個 Quartz 頁面的基本設定
  • .github/workflows/deploy.yml:調整 GitHub Actions 設定

直接與 Obsidian 連接

作者也有為 Obsidian 做專屬外掛,可以單純在 Obsidian 內做一切需要的操作。

外掛文檔


參考資料

  1. https://www.youtube.com/watch?v=6s6DT1yN4dw