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

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

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

難度

  • 非工程師:⭐⭐⭐⭐⭐
  • 工程師:⭐⭐⭐
截自討論串:Best way to self-host obsidian

前言

一直以來都有用筆記軟體的習慣,從老字號 Evernote、風靡全球的 Notion 、簡單直白的 Google Document、模擬人腦思考的 Heptabase ...也都有關注。

會認識 Obsidian 是因為我發現自己喜歡將筆記之間做 “連結(link)“,但試用其他筆記軟體都覺得不太符合我想要的功能(Heptabase 沒用是因為要付費XD)。

最近在構思用 Obsidian 製作 Leetcode 模板筆記,就想何不研究一下如何讓他變成一個人人都能觀看的網站? 之後才找到這個 Quartz + Obisidian 的方案,看了幾個網站成品(如 toolbox.socratica.infoquartz.eilleeenz.com) 也覺得效果不錯,決定來嘗試一下!

依照 Quartz 步驟設定

Quartz 由 Jacky Zhao 開發,能夠讓你將 Obsidian 筆記部署成個人筆記網站。我據官方教學文檔步驟操作,大概花了40分鐘就可以完成。

建議這裡選 Empty Quartz。如果你原本有其他內容,可以手動複製過來

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

啟動後會跑在localhost:8080/

連結 Vercel 與 Github

由於 Quartz 本質上是一個 Static Site Generator (類似Astro、Hugo等),在官方部署教學中,也支持用 Github Pages 或 Vercel 進行部署。我最後選擇 Vercel。

在本機端測試後,通過 npx quartz sync就可以將文章同步到 Github > Repo > v4分支。

在本機端時,記得要手動設定git remote set-url {your_repo},才能sync​ 成功
在 Vercel 部署時,需要去設定 Settings > Build and Deploymeny 調整指令

最後就大功告成!

連結:https://obsidian-leetcode.vercel.app

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

預約時間