← Default view
~/vault $ obsidian-roadmap --from=beginner --to=intermediate --notes=1200 --unused=templates,bases
Adoption-order roadmap · five milestones

Beginner intermediate Obsidian: a roadmap for a developer with a 1,200-note vault

expedition synthesis · five chapters 121 sources 38-min canonical · 6-min roadmap read the canonical
starting position · `git status` for your vault
notes: ~1,200 tracked
domains: movies · series · books · places · recipes · daily
templates: staged but unused
.base files: staged but unused
markdown: fluent
git: fluent
yaml: fluent
obsidian-features: beginner
load-bearing claim

Properties are the load-bearing prerequisite, not Bases. A .base file is empty until the notes it points at carry consistent YAML frontmatter [1]. Bases ignores inline key::value Dataview metadata entirely [3].

Five chapters, individually presenting linear paths — collapsed for the existing-vault, never-used-the-features developer, the order reshuffles.
vault graph · the roadmap as nodes & edges
01 properties wake the .base 02 one wikilink before close 03 capture loop daily + hotkey 04 three MOCs dump · lump · jump 05 keyboard-first switcher++ & chords
roadmap milestone adoption edge existing note (×1,200) backlink
1

Stamp four properties on one reference folder. Wake the matching .base.

load-bearing

Why it matters. Both the Properties and Bases chapters arrive at the same gating step: the dormant .base file already sitting in the vault is empty because none of the notes underneath it carry YAML frontmatter that matches [1]. Add four properties — type, status, rating, date — to one reference template and re-save the existing notes through it; the .base view lights up [2]. Pick the folder where you already make manual decisions (books, films, recipes, places); that's where the live view will earn its keep.

first step · paste into the chosen template
# templates/book.md
---
type:   book
status: "backlog"   # backlog · reading · done · abandoned
rating:           # 1..5, fill on close
date:   
---
2

One [[wikilink]] per new note, before you close it. New notes only.

discipline

Why it matters. The linking chapter's hard rule, and the cheapest possible upgrade [6]: every new note carries at least one link before you hit close. Steph Ango (Obsidian CEO) runs a four-folder vault and navigates entirely by Quick Switcher and backlinks — the file tree disappears as a primary surface [16]. The constraint that pays: new notes only. Don't backfill the 1,200; re-organising folders to chase a perfect tree is the trap that burns the time meant for new linking discipline [8].

first step · the rule as a one-liner
# enforce before close (no plugin needed — just habit):
if grep -q '\[\[' "$NEW_NOTE"; then close; else link-something; fi
3

Five-line daily-note template. One capture hotkey. No Periodic Notes yet.

habit

Why it matters. The capture chapter's central claim: build the habit before the system [9]. Templates over ten sections collapse under their own weight — consistency beats quality [13]. Once the daily becomes the default hub, short-lived ideas get a default home and the new-note flow that Step 2 needs starts feeding itself [25]. Don't reach for Periodic Notes yet — Daily Notes core is the minimum that proves the habit sticks [10].

first step · the entire daily template
# templates/daily.md
# {{date:YYYY-MM-DD}}

## notes
-

## log
- 
4

Three MOCs over the existing reference collections. Dump → Lump → Jump.

structure

Why it matters. Once Step 3 starts producing new-note volume, orphans become visible in the graph view, not in the file tree. Three Maps-of-Content — broad topic anchors — absorb them [7]. MOCs let you describe, order, and format what you link to in ways tags cannot [19]. Don't try to MOC the whole vault — start with the broadest three (e.g. Reading.md, Watching.md, Places.md) and let need do the rest.

first step · the dump-lump-jump pass
# Reading.md — a Map-of-Content, not an index
## currently            # jump
- [[Anna Karenina]]
## recent best          # lump
- [[Severance — Cline]]
- [[The Power Broker]]
## backlog              # dump
- [[Stoner]] · [[Piranesi]] · [[Pachinko]]
5

Layer Quick Switcher++ & keyboard chords once the file explorer is the bottleneck.

when it hurts

Why it matters. The plugin chapter's restraint principle: don't install the keyboard stack on day one — install it when reaching for the mouse to find a note becomes the slow step. The four default chords carry most of the weight: Ctrl+P palette, Ctrl+O switcher [14], Ctrl+Shift+F global search, Ctrl+Shift+T reopen tab [15]. Bias chords toward the left hand so you don't have to leave home row [24]. Adopt the rest only when the previous step's pain is real.

first step · the four chords, in order of return
Ctrl+O         open any note by name        # 80% of switches
Ctrl+P         command palette              # every other action
Ctrl+Shift+F   global search across vault   # when you forgot the title
Ctrl+Shift+T   reopen last closed tab       # the safety net
unresolved · scale tension

Topic tags: kill them or keep them?

The linking chapter says tags are for status & type, not topic. The properties chapter allows broad topic tags as one of three legitimate categories [17]. Both right at different scales: at 100 notes, prune to status/type/topic with two tags max. At 1,200 notes, topic tags are already in the wild — pruning them costs more than tolerating them. Don't refactor.

unresolved · sequencing tension

Property-stamping or daily habit first?

If templates and .base files exist but no new notes flow in, no amount of property-stamping pays off — the Bases chapter holds the proof-step, the capture chapter holds the habit [9]. Run Steps 1 and 3 in parallel, not in series. Step 2 (one wikilink) and Step 4 (three MOCs) chain off whichever ships first.

five chapters · in canonical's frontmatter order
01
Linking & note structure: backlinks, MOCs vs folders
Adoption-ordered path from folder-thinking to link-thinking: one wikilink per note, then three MOCs, then ACE/PARA only if you need it.
survey
17 sources · 6 min
02
Properties & tagging for queryable notes
How to add structured metadata so Bases and Dataview can query them — when a property, when a tag, naming rules that keep both useful.
survey
14 sources · 6 min
03
Bases: turn existing reference notes into live views
The .base format, conversion workflow, ready-to-steal recipes, formula language, and where Dataview still wins.
expedition
42 sources · 11 min
04
Low-friction capture & daily-note habits
The smallest viable capture loop — five-line daily template, one hotkey, one mobile pathway, one weekly pass — over four weeks.
survey
20 sources · 9 min
05
Core + community plugins & keyboard-driven navigation
Which core plugins to enable, the tight community-plugin starter pack, hotkey patterns that turn a beginner into keyboard-first.
survey
28 sources · 6 min
sources cited in this view
[1]Obsidian Help — Bases
obsidian.md · official
[2]Complete guide to properties
practicalpkm.com
[4]Help — Properties
obsidian.md · official
[5]Help — Link notes
obsidian.md · official
[6]Orphan notes & linking
makeuseof.com
[7]5 levels of MOCs
aidanhelfant.com
[8]How I use folders
obsidian.rocks
[9]Quick capture
obsidian.rocks
[10]Help — Daily notes
obsidian.md · official
[11]obsidian-periodic-notes
github · ⭐ 1.3k
[12]Templater
github · ⭐ 5.0k
[13]Daily-notes workflow
aiproductivity.ai
[14]Help — Quick switcher
obsidian.md · official
[15]Keyboard shortcuts
xda-developers.com
[16]Steph Ango — vault
stephango.com · CEO
[17]How to use tags
practicalpkm.com
[18]Tags in markdown
desktopcommander.app
[19]MOC vs tagging
forum.obsidian.md
[20]Weekly review
bagerbach.com
[21]obsidian-git
github · ⭐ 11k
[22]QuickAdd
github · ⭐ 2.2k
[23]Core plugins
obsidian.md · official
[24]Hotkey best practices
forum.obsidian.md
[25]Daily notes hub
dsebastien.net
// colophon   The canonical synthesis reorders chapter [02] Properties ahead of chapter [03] Bases for an existing-vault, never-used-the-features reader. This view inlines that reshuffle as a five-step adoption path. Two tensions stay live: topic-tag pruning at 1,200 notes (cost > benefit) and the property/habit sequencing question (run in parallel, not series). See the canonical for full citations across all five children.