Obsidian is a free, offline-first note-taking app built on one powerful idea: your notes should connect to each other. Unlike traditional note apps where ideas live in isolated files, Obsidian lets you build a personal knowledge base where every note can link to every other note — and those links compound in value over time.

This tutorial walks you from installation to a sustainable, long-term setup, including plugins, themes, sync, and where AI fits in.

When to Use Obsidian (and When Not To)

Obsidian is right for you if:

  • You want to keep your notes forever — they're plain Markdown files on your computer, no vendor lock-in, no subscription hostage situation.
  • You're a student, researcher, writer, or developer who needs to connect ideas across topics, not just store them.
  • You value privacy — your vault works fully offline.
  • You like owning and customizing your tools rather than renting them.

Consider alternatives if:

  • You need heavy real-time collaboration (Notion or Google Docs wins).
  • You want a structured database-out-of-the-box experience (Notion is more opinionated).
  • You only take a handful of simple notes (Apple Notes or Google Keep is lighter).

Action step: If you're unsure, just try it. Download Obsidian (free for personal use) and commit to 14 days of daily use before judging it.

Creating a Vault & Linked Notes

Everything in Obsidian lives in a vault — just a regular folder on your computer containing Markdown (.md) files.

Setup (5 minutes):

  1. Open Obsidian → Create new vault → name it (e.g., My Vault) → choose a location.
  2. Create your first note with Ctrl/Cmd + N.
  3. Start linking. This is the core skill:
# My First Note
Reading about [[spaced repetition]] changed how I study.
Related: [[Learning How to Learn]]

Type [[ and Obsidian autocompletes note names. If the note doesn't exist yet, the link creates a placeholder — clicking it later creates the note. Don't worry about creating the note now; link first, fill in later.

Why this matters: Every linked note automatically shows backlinks — every other note that references it. Your structure emerges from writing, not from filing. Try it: create three notes about any topic and link them together, then open the Graph view (left sidebar icon) and watch your mini knowledge web appear.

Quick Tips

  • Readable line length driving you crazy? If your note looks too narrow — especially in split view — disable it: Settings → Editor → Display → Readable line length (OFF). If you're using a custom theme, look for width settings, or override precisely with a CSS snippet in Settings → Appearance → CSS Snippets (body { --file-line-width: 850px; }). Full walkthrough: Increase Obsidian Note Width (Right Panel) – Quick Fix Guide.
  • Daily Notes first. Turn on the Daily Notes core plugin (Settings → Core plugins) and start every session in today's note. It's your anchor.
  • Learn 5 keyboard shortcuts: Ctrl/Cmd+N (new note), Ctrl/Cmd+O (quick open), Ctrl/Cmd+P (command palette — your best friend), Ctrl/Cmd+E (edit/preview toggle), Ctrl/Cmd+Shift+F (search).
  • Use the Command Palette for everything. If you don't know how to do something, press Ctrl/Cmd+P and type it.
  • Templates: Enable the Templates core plugin, create a Templates folder, and stop formatting notes from scratch.

Most Common Mistakes

  1. Designing the perfect folder structure before writing a single note. This is the #1 beginner trap. You end up with a beautiful, empty filing system. Write first, organize later.
  2. Collecting, not thinking. Copy-pasting article highlights into a vault creates a hoarder's attic, not a knowledge base. Every note should contain your words and your connection to other ideas.
  3. Installing 40 plugins in week one. Each plugin adds friction and maintenance. Start with core features; add plugins only when you feel a specific pain.
  4. Treating Obsidian like Notion. Obsidian's strength is linking, not databases. If you try to rebuild Notion-style wikis with property overload, you'll fight the tool.
  5. Over-tagging. Tags like #productivity or #psychology duplicate what links and MOCs already do. Use tags for states (#in-progress, #to-review), not topics.
  6. Never reviewing. Unlinked, abandoned notes decay. A monthly 30-minute review keeps the vault alive.
  7. No backup. Plain files are durable — but only if you back them up. We'll cover sync below.

How to Make Notes Smarter

The note-writing formula that works:

  1. Atomic notes — one note = one idea. If a note covers three topics, split it.
  2. Write in your own words. If you can't paraphrase it, you haven't learned it.
  3. Link aggressively. Every time a concept appears that could be its own note, [[link it]] — even if the note doesn't exist yet.
  4. Use properties (metadata) sparingly but deliberately. At the top of a note, press --- to add YAML frontmatter like status: draft or rating: 4. Useful for filtering later, harmful when overdone.
  5. Add a "why" line. Every permanent note should answer: Why is this worth keeping? What does it connect to?
  6. Summaries on top. Future-you has 3 seconds of patience. Lead with the key idea.

Action exercise: Take one note you wrote this week and rewrite it: one idea, your own words, three outbound links, one-line summary at the top.

How to Organize Obsidian

Here's the counterintuitive truth: the best way to organize Obsidian is to barely organize it at all. For the full philosophy — with PARA, Maps of Content, and why structure should emerge from use rather than planning — read this companion guide: Stop Organizing Your Obsidian Notes (Do This Instead).

The practical version:

Principle 1: Capture first, structure later.
For your first 4–6 weeks, dump everything into a single Inbox folder. Don't file anything. Patterns will emerge naturally, and those patterns — not a guru's template — should drive your structure.

Principle 2: Use a light top-level structure (optional).
If you want scaffolding, use PARA — organize by actionability, not topic:

📁 1 Projects      → things with deadlines (Launch Website)
📁 2 Areas         → ongoing responsibilities (Health, Finances)
📁 3 Resources     → reference topics (Python, Marketing)
📁 4 Archives      → completed/inactive
📁 Inbox           → everything new lands here first

Principle 3: Trust links over folders.
Folders are broad buckets; Maps of Content (MOCs) do the real work. A MOC is a note whose only job is linking to other notes on a theme:

# [[Cognitive Biases]] — MOC
- [[Anchoring Bias]]
- [[Survivorship Bias]]
- Related: [[Decision Making]], [[Behavioral Economics]]

Principle 4: Links for nouns, tags for states.

  • [[Concept Name]] — for ideas, people, projects (things that deserve their own note)
  • #to-review, #draft, #quote — for process states and filtering

Principle 5: Monthly review (non-negotiable).
Once a month, 30 minutes: connect orphan notes, clear the Inbox, update MOCs, archive finished projects. This single habit prevents vault decay.

Plugins

Obsidian has 2,000+ community plugins. As a beginner, you need very few. Here's the sane progression:

Week 1–2: Core plugins only. Enable: Daily Notes, Templates, Graph View, Backlinks, Canvas. That's a complete system.

When you feel friction, add ONE plugin that solves it:

Need Plugin
Track tasks across notes Tasks
Custom callouts, visual tweaks Style Settings
Note-taking on PDFs/articles Annotator or Web Clipper
Spaced repetition learning Spaced Repetition
Calendar view of daily notes Calendar
Capture from browser/mobile Obsidian Web Clipper (official)

Rules to stay sane:

  • Install one plugin at a time; use it for a week before adding another.
  • Avoid overlapping plugins (e.g., don't run three different task managers).
  • Every few months, audit and uninstall anything you haven't used — plugins you don't use are just baggage that slows load times.

Themes

Obsidian's default look is clean, but themes make long writing sessions more pleasant.

Getting started:

  1. Settings → Appearance → Themes → Manage → browse and install in one click.
  2. Popular beginner-friendly options: Minimal (clean, pairs with the Style Settings plugin), AnuPpuccin, Border, Things.

Practical advice:

  • Change one variable at a time: theme first, then font (Settings → Appearance → Font), then CSS snippets if needed.
  • Dark vs. light: pick what matches your working hours. Many users keep light for day, dark for evening.
  • Don't theme-hunt weekly. Find one that feels invisible and stay with it. The note width fix mentioned earlier also applies per-theme — most quality themes expose width controls.

Synchronization

Your notes are just files — which means you have real options. Here's how to think about them:

Option 1: Obsidian Sync (official, ~$4–8/month).
Easiest by far: end-to-end encrypted, works on all platforms including iOS, version history included. If you want zero friction and can pay, this is it.

Option 2: Syncthing (free, self-hosted, private).
Peer-to-peer sync with no cloud server — your notes never touch anyone's servers. Fully free, works on Windows/macOS/Linux/Android; iOS via the SyncTrain app. The key practices:

  • Install Syncthing on each device, pair them via Device IDs
  • Add your vault folder, share it across devices
  • Enable File Versioning (keep 5 versions) — a free safety net against sync accidents
  • Ignore the .obsidian folder on mobile to prevent settings/plugin conflicts
  • Edit a note on only one device at a time to avoid .sync-conflict files

Step-by-step setup with screenshots and troubleshooting: How to Sync Obsidian Notes Across Multiple Devices with Syncthing.

Option 3: Git (free, for technical users).
Commit your vault to a private GitHub repo. Version control, free backup, and sync in one. The Obsidian Git plugin automates it.

Option 4: iCloud/Dropbox/Google Drive.
Works on desktop, but mobile support is shaky (especially on iOS and Android) — these services don't understand Obsidian's database-like file access. Use them as backups, not live sync.

Whichever you choose: have at least one backup that is not the sync itself. Sync replicates mistakes; backups undo them.

AI & Obsidian's Future

AI is reshaping note-taking, and Obsidian sits in an interesting position: because your notes are local Markdown files, any AI tool can read them — you're not locked into one vendor's AI.

What you can do today:

  • Obsidian's own AI features — the official Copilot plugin (community) and emerging native AI capabilities let you chat with your vault, summarize notes, and auto-tag.
  • Use your vault as context for external AI — export or sync notes to tools like ChatGPT/Claude projects and ask questions about your own thinking.
  • AI-assisted linking — plugins can suggest missing connections between notes, surfacing links you'd never have made manually.

Where this is heading:

  1. From storage to conversation. Notes shift from passive archives to things you interrogate: "What have I written about decision-making?" becomes a question you ask your vault, not a search you run.
  2. Auto-organization. AI will handle tagging, MOC generation, and deduplication — meaning your job becomes purely writing and thinking, which is exactly what the "organize less" philosophy above recommends.
  3. The durable advantage. As AI tools come and go, the people who win are those whose knowledge lives in portable, open formats. Obsidian's plain-Markdown architecture makes your notes the most AI-ready and future-proof notes you can own.

The enduring principle doesn't change: AI can organize, summarize, and connect — but it can't think for you. The vault's value still comes from notes worth connecting.

Your 7-Day Starter Plan

  1. Day 1: Install, create vault, write one note.
  2. Day 2: Turn on Daily Notes; write today's entry.
  3. Day 3: Create three notes and link them together.
  4. Day 4: Build your first MOC.
  5. Day 5: Set up one template (daily note or meeting note).
  6. Day 6: Choose sync + backup. Done beats perfect.
  7. Day 7: Review the week. What patterns emerged? Adjust, don't rebuild.

Keep it simple, write more than you organize, and let the structure grow out of your actual thinking. That's the whole game.