Quartz 4

obsidian-setup

4 min read

Obsidian Setup

vault 把 Obsidian 當作前端編輯/瀏覽器。Obsidian 不是必要 — 全 Markdown 結構,純文字編輯器也能用,但有幾個 plugin 會大幅提升體驗。

1. 安裝 Obsidian

  • Windows: winget install Obsidian.Obsidian
  • Mac: brew install --cask obsidian
  • Linux: 官網下載 AppImage

第一次開啟 → 「Open folder as vault」→ 選 D:\lab\suxi\suxi-learning。

2. 核心設定 (Settings → …)

Files & Links

  • Default location for new notes: daily/(若你常從 daily 起手)或 In folder under root 留空,自行指定。
  • New link format: Shortest path when possible
  • Use Wikilinks: ✅ on
  • Default location for new attachments: In subfolder under current folder,subfolder name: attachments

Editor

  • Strict line breaks: ✅ on(避免單行斷不開)
  • Spellcheck: 視語言開
  • Show frontmatter: ✅ on

Appearance

  • 字體建議 mono 數字:JetBrains Mono / Cascadia Code(中文 fallback Noto Sans TC)。

3. 推薦 Community Plugins

Settings → Community plugins → Turn off restricted mode → Browse

Plugin用途設定建議
Templater強化模板(可放 JS、自動帶日期)Template folder: templates。把 chunk/source/daily.md 的 {{date:...}} 改成 Templater 語法 <% tp.date.now("YYYY-MM-DD") %>。
Dataview用查詢語法做 dashboard用來在 index.md 列出全部 type: chunk 且 next_review < today 的卡。
Spaced Repetition把 chunks/ 變成抽認卡在 chunk 內用 ? 分隔 question/answer,或用標籤觸發。設定 → tag #flashcards 或 folder chunks/。
Periodic Notes自動帶 daily / weekly / monthlyDaily template: templates/daily.md,format YYYY-MM-DD,folder daily/。
Tasks把 - [ ] 變成可查詢任務配合 daily 的「待整理」section。
Tag Wrangler重新命名 tag、看 tag pane不用設定,裝完就好。
Excalidraw手繪圖、架構圖Attachment folder: 跟一般檔案一起 attachments/。
Advanced Tables表格自動排版開啟 Auto format tables。
Outliner巢狀清單操作預設快捷鍵 Tab/Shift+Tab 縮排。
Iconize (選用)給資料夾加 icon,raw/wiki/chunks 一眼分得開各層配色:raw 灰、wiki 藍、chunks 綠。
Git (Obsidian Git)vault 自動 commit/pushAuto backup interval: 60 min,auto pull on startup: ✅。生產環境慎用 force push。

4. Hotkey 建議

動作預設建議
Open daily note—Ctrl+Shift+D
Insert templateTemplaterCtrl+Shift+I
Open command paletteCtrl+P保持
Quick switcherCtrl+O保持
Search in all filesCtrl+Shift+F保持
Toggle edit/previewCtrl+E保持
Spaced Repetition review—Ctrl+Shift+R

5. Dataview 起手式 (放 index.md 末段)

TABLE next_review, recall_difficulty
FROM "chunks"
WHERE type = "chunk" AND next_review <= date(today)
SORT next_review ASC
TABLE last_reviewed, domain
FROM "wiki"
WHERE last_reviewed < date(today) - dur(90 days)
SORT last_reviewed ASC
LIMIT 20

6. 不裝 Obsidian 的替代

  • VS Code + Markdown All in One + Foam extension(雙鏈)
  • Neovim + obsidian.nvim
  • 純 CLI:rg + fd + 編輯器,搭 git grep 找雙鏈。

vault 結構不依賴 Obsidian。換編輯器隨時。

7. 跨機同步

選一個,不要混用:

  1. Git (推薦):雲端是 GitHub,衝突自己解。免費、可控、有 history。
  2. Obsidian Sync:官方付費,$10/月,適合手機 + 桌面雙端。
  3. iCloud / OneDrive / Dropbox 同步資料夾:有風險 — .obsidian/workspace.json 兩端會打架。若用,務必把 .obsidian/workspace* 排除掉(.gitignore 已排除,但雲端同步要另外設)。

8. 故障排除

  • 雙鏈失效 → 檢查 Settings → Files & Links → New link format,改成 Shortest path when possible。
  • Templater 沒帶日期 → 確認 template 是 <% %> 不是 {{ }},且 template folder 設對。
  • Git plugin commit 失敗 → 多半是換行符(CRLF/LF)。git config --global core.autocrlf true(Windows)。
  • Dataview 不更新 → 重新整理頁面或 Ctrl+R,或 plugin 設定 → Refresh interval 設短一點。

Graph View

Backlinks