Getting Started with Obsidian on Mac: A Complete Setup Guide

I've tried every notes app on the Mac. Bear for its elegance. Notion for its databases. Apple Notes when I want to pretend I'm a simple person. None of them stuck the way Obsidian has — and I think that's because Obsidian is the first app that treats your notes as yours: plain Markdown files on disk, no proprietary format, no hostage situation if the company pivots or disappears. But that openness comes with a cost. The first hour with Obsidian can feel like standing in an empty warehouse with a blueprint in one hand and a box of power tools in the other. This guide is what I wish I'd read before I spent three weeks building a vault I had to tear down and start over.

Why Does Obsidian Win Against Bear, Notion, and Apple Notes?

Let me be honest about the competition. Bear is genuinely beautiful and fast — if you're writing short-form notes and staying inside Apple's ecosystem, Bear 2 is hard to beat. Notion is a collaborative workspace tool masquerading as a notes app; it's excellent for teams and structured data, but it's slow, it's cloud-only, and your content lives in their database. Apple Notes is the cockroach of productivity — it'll be there when everything else fails — but you can't do bidirectional linking or meaningful graph traversal.

Obsidian wins for one reason: the data model. Your vault is a folder of .md files. You can back it up with Time Machine, rsync it to a server, open it in any text editor, and grep through it from Terminal. When I moved my old Notion notes, I ran a Python script against the export and had 400 notes in Obsidian in twenty minutes. Try doing that in the other direction.

That said, Obsidian is not for people who want a polished, opinionated experience out of the box. If you want something that just works with zero decisions, start with Bear and come back here when you outgrow it.

Where Should You Actually Store Your Vault?

This is the decision that will either serve you for years or cause you subtle misery. You have three real options:

1. iCloud Drive — convenient on paper, but iCloud's file-on-demand behavior and sync timing can cause Obsidian to open a note that hasn't fully downloaded yet. I've had files show as blank for thirty seconds on a slow connection. Not catastrophic, but annoying.
2. Dropbox — faster and more reliable than iCloud for sync, especially if you're on a mixed Mac/iOS setup. The Dropbox file-system extension plays well with Obsidian's watcher.
3. Local only, with a manual backup — the purist move. Put the vault in ~/Documents/Obsidian/, then back it up with Time Machine plus a git remote. This is what I do. Zero sync conflicts, instant file access, full control.

The gotcha nobody mentions: if you ever enable Obsidian Sync (their paid service) on top of iCloud, you'll get double-sync conflicts within a week. Pick one sync mechanism and commit. Obsidian Sync is excellent if you want seamless iOS support and don't want to think about it — worth the $4/month for many people.

What's the Right Vault Structure for Day One?

The internet will try to sell you elaborate systems — PARA, Zettelkasten, Johnny.Decimal. Ignore all of it for the first two weeks. A structure you don't understand yet is a structure you'll abandon. Start with this and evolve it organically:

• 📥 Inbox/ — everything lands here first. Brain dump, no pressure.
• 📝 Notes/ — processed, evergreen notes that live on their own terms.
• 📁 Projects/ — one sub-folder per active project, archived when done.
• 🗓 Journal/ — daily notes go here automatically (you'll set this up in two minutes).
• 📚 References/ — book notes, article summaries, things you consumed.

The rule I follow: if I can't decide where something goes, it goes in Inbox. I process Inbox once a week. That single habit prevents the "everything is everywhere" rot that kills most vaults.

Which Core Plugins Should You Enable in the First Session?

Obsidian ships with a set of core plugins that are off by default. Go to Settings → Core plugins and turn these on immediately:

1. Daily notes — set the folder to Journal/ and the date format to YYYY-MM-DD. The ISO format sorts correctly in your file system forever. Do not use MM-DD-YYYY unless you enjoy chaos.
2. Templates — set the template folder to a hidden folder like _templates/. The underscore keeps it at the top of your sidebar and signals "infrastructure, not content."
3. Backlinks — enable "Show backlinks in document." This is the superpower. When you create a note about a person or a project and later mention them anywhere in your vault, the backlinks pane will show you every connection automatically.
4. Outline — a table of contents for long notes. Opens in the sidebar. Indispensable once your notes get past 500 words.
5. Word count — shows in the bottom status bar. Simple, but I look at it constantly.

Leave Graph view off for now. It's visually compelling and functionally useless until your vault has several hundred interconnected notes. Opening it on day one is like looking at your neural pathways with an empty brain.

What Theme and Appearance Settings Actually Matter?

The default Obsidian UI is functional but a little rough. The single best upgrade is installing the Minimal theme by @kepano (Settings → Appearance → Manage → search "Minimal"). It strips away most visual chrome and lets your content breathe. It also has a companion plugin, Minimal Theme Settings, that exposes font and color controls without CSS editing.

After installing it, adjust these specific settings — they're buried and the defaults are wrong:

1. Settings → Appearance → Readable line length — turn this ON. Without it, your notes stretch across the full editor width. Reading a 1200px-wide line of prose is exhausting.
2. Settings → Editor → Default font size — bump to 16px minimum. 14px is a squint tax.
3. Settings → Editor → Vim key bindings — only if you know Vim. If you don't, leave it off and thank me later.
4. Settings → Files & Links → Default location for new notes — set to "In the folder specified below" and point it at Inbox/. Otherwise new notes scatter to wherever you were last working.

What Are the Gotchas the Docs Don't Tell You?

A few things I learned the hard way:

• Wikilinks vs. Markdown links — Obsidian defaults to [[wikilinks]], which are Obsidian-specific. If you ever want your notes to be portable to another app, go to Settings → Files & Links and switch to Markdown links. This is a religious debate in the community; I use Markdown links and sleep fine.
• Attachment folder — drag an image into a note and Obsidian will dump it in the vault root by default. Fix this before you start: Settings → Files & Links → Default attachment folder → set to _attachments/. Otherwise you'll have 200 PNGs named "Pasted image 20260618..." littering your vault root.
• The community plugins rabbit hole — there are 1,500+ community plugins. You do not need most of them. The ones worth looking at after you've used Obsidian for a month: Dataview (query your notes like a database), Templater (a far more powerful Templates replacement), and Calendar (a monthly view for daily notes). Install them one at a time with a week between each, or you'll spend more time configuring plugins than writing notes.
• Renaming notes is safe — Obsidian automatically updates all internal links when you rename a file. Don't be precious about naming on day one. Get words down, rename later.

What Habits Actually Make Obsidian Stick Long-Term?

The app is only as good as the practice you build around it. After two years of daily use, the habits that actually compounded:

1. Open the daily note first thing — before email, before Slack. Write three lines: what you're doing today, one thing you're thinking about, one thing you want to remember from yesterday. It takes four minutes and creates a searchable log of your working life.
2. Link obsessively, file lazily — when you mention a person, project, or concept, type [[ and link it. Don't worry about whether the note exists yet. The backlinks panel will grow a network for you without any folder discipline.
3. Process Inbox every Friday — block fifteen minutes. Move notes to their permanent home or delete them. A full Inbox is fine during the week. A full Inbox on Monday of the following week means you've lost the context to process them.

The biggest mistake new Obsidian users make is spending their first month building the perfect system instead of using an imperfect one. The vault that serves you in year two will look nothing like the vault you imagined in week one — and that's completely fine.

Obsidian has a learning curve, but it's the kind of curve where every hour you invest compounds. The notes I wrote eighteen months ago link to things I'm thinking about today. No other tool I've used has given me that feeling of a mind that accumulates rather than forgets.