如何用 Obsidian + Quartz 架設個人筆記網站

今天會介紹如何運用 Quartz 插件,將你的筆記轉變成個人網站。這篇文章預期讀者對於 Obsidian 有基礎認識,內容也會用到 GitHub、Vercel 這兩個技術工具,適合對軟體開發有初步了解、或者有工程背景的讀者閱讀。
難度
- 非工程師:⭐⭐⭐⭐⭐
- 工程師:⭐⭐⭐

前言
一直以來都有用筆記軟體的習慣,從老字號 Evernote、風靡全球的 Notion 、簡單直白的 Google Document、模擬人腦思考的 Heptabase ...也都有關注。
會認識 Obsidian 是因為我發現自己喜歡將筆記之間做 “連結(link)“,但試用其他筆記軟體都覺得不太符合我想要的功能(Heptabase 沒用是因為要付費XD)。
最近在構思用 Obsidian 製作 Leetcode 模板筆記,就想何不研究一下如何讓他變成一個人人都能觀看的網站? 之後才找到這個 Quartz + Obisidian 的方案,看了幾個網站成品(如 toolbox.socratica.info、quartz.eilleeenz.com) 也覺得效果不錯,決定來嘗試一下!
依照 Quartz 步驟設定
Quartz 由 Jacky Zhao 開發,能夠讓你將 Obsidian 筆記部署成個人筆記網站。我據官方教學文檔步驟操作,大概花了40分鐘就可以完成。

在你本機端設定後,執行 npx quartz build --serve
就可以看到網站跑起來,就像一般開發前端網站一樣。但它最優秀的地方在於你可以用 Obsidian 打開來編輯,享受絲滑的寫文章體驗😍

連結 Vercel 與 Github
由於 Quartz 本質上是一個 Static Site Generator (類似Astro、Hugo等),在官方部署教學中,也支持用 Github Pages 或 Vercel 進行部署。我最後選擇 Vercel。
在本機端測試後,通過 npx quartz sync
就可以將文章同步到 Github > Repo > v4分支。


最後就大功告成!

卡關或不知道如何開始?歡迎透過下方連結,預約免費諮詢