Most note apps rent you your own thinking. Your notes live in their database, in their format, behind their login — and if they raise the price or shut down, you're negotiating for your own work. Obsidian works the opposite way: it's a viewer for a folder of Markdown files that already belong to you.
The thing most guides get wrong: Obsidian used to require a paid Commercial licence if you used it for work at a company of 2+ people. That requirement was removed on 20 February 2025. Their licence page now reads: "Obsidian is free for all purposes, including personal, commercial, and non-profit use." If an article tells you that you need to pay for work use, it's out of date.
What's in this guide
1. Why it's different
A vault is just a folder. Obsidian's own docs put it plainly: "Obsidian stores your notes as Markdown-formatted plain text files in a vault. A vault is a folder on your local file system."
That one design choice cascades into everything:
- You can open your notes in anything. Any text editor, any file manager. Obsidian picks up external changes automatically.
- It works offline. No sync spinner, no server round-trip.
- Nobody can read them. Their homepage: "No one else can read them, not even us." Their pricing FAQ adds that the apps collect no telemetry and never sell user data.
- No account required. Download, open, start typing.
- If Obsidian disappeared tomorrow, you'd still have every note. They're `.md` files. That's the whole point.
The other half is links. Type [[ and you connect two notes. Do that for a few months and you stop having a pile of documents and start having something with shape — which is the actual pitch behind "second brain."
2. Download & 5-minute setup
Available on Windows, Mac, Linux, iOS and Android. Linux ships as AppImage, Snap, Deb, ARM64 and a community Flatpak.
obsidian.md/download — no account, no email, no card.
- Install and open itPick "Create new vault." Name it something boring like
notes. - Choose where the folder lives — this mattersPut it somewhere you can find in Finder or Explorer. If you plan to sync with iCloud or Dropbox later, put it there now; moving it afterwards is more annoying than it should be.
- Make one note and link itCreate a note. Type
[[and the name of a second note. Obsidian creates it on the spot. That's the entire core mechanic. - Turn on Bases (it's built in)Settings → Core plugins → Bases. It gives you database-style Table, List, Cards and Map views over your notes — no third-party plugin needed.
- Install the Web ClipperFree browser extension for Chrome, Safari, Firefox and Edge. Saves any page into your vault as clean Markdown. This is what turns Obsidian from a notes app into a research tool.
That's genuinely it. Don't install thirty plugins on day one — the failure mode with Obsidian isn't that it's underpowered, it's that people spend three weeks configuring it and zero weeks writing.
3. The features worth knowing
Links & graph
Connect notes with [[. The graph view draws the whole web of connections. Backlinks show you every note pointing at the one you're reading — which is where the useful accidents happen.
Canvas — free
An infinite whiteboard where you can drop notes, images, PDFs, video and live web pages, then draw the connections. Saved in JSON Canvas, an open format they published so other apps can read it.
Bases
A core plugin since 2025. Turns your notes and their properties into Table, List, Cards or Map views — Notion-style databases, except the data stays in your own Markdown files. Kanban and Calendar views are on the roadmap, not shipped yet.
Web Clipper
Free, open-source browser extension. Clips articles to Markdown with templates for articles, recipes and papers. Everything lands in your local vault.
Obsidian CLI — the one for this audience
Shipped February 2026. Control your vault from the terminal: "Anything you can do in Obsidian you can do from the command line." Their own pitch includes "Give agentic tools the ability to interact with your vault" — so Claude Code or any agent can read and write your notes directly. Enable it under Settings → General → Command line interface.
Also in the box: Live Preview editing, PDF viewer, Mermaid diagrams, LaTeX, daily notes, templates, Vim mode, and an importer for Notion, Evernote, Roam, Google Keep, OneNote and Apple Notes.
4. What it actually costs
| Thing | Price | What you get |
|---|---|---|
| The app | Free | Everything above. Personal, commercial, non-profit, education, government. |
| Sync Standard | $4/mo annual | 1 vault, 1GB, 5MB max file, 1 month history |
| Sync Plus | $8/mo annual | 10 vaults, 10GB, 200MB max file, 12 month history |
| Publish | $8/mo per site | Host a public site from your notes, custom domain |
| Catalyst | $25 one-time | Optional. Early access to betas + community badge. |
| Commercial | $50/user/yr | Optional. A way to support them, not a requirement. |
Students, faculty and non-profit employees get 40% off Sync and Publish. Sync and Publish have a 7-day no-questions refund; Catalyst and Commercial licences don't.
Worth being precise about, since their own site isn't: the homepage says Sync gives "one year of version history", but the Sync pricing table says 1 month on Standard and 12 months on Plus. Go by the pricing table.
5. Syncing across devices — including free ways
Obsidian Sync is the paid first-party option, end-to-end encrypted with AES-256. But because your vault is just a folder, you don't have to use it. Obsidian documents the alternatives themselves:
- iCloud — works well across Mac/iPhone/iPad. Their docs warn that iCloud Drive on Windows may cause file duplication or corruption.
- OneDrive / Google Drive — both work on desktop, but neither is officially supported for iOS.
- Syncthing — free, local, no cloud. Works best if one device is always on.
- Git — real version control, but not automatic; you push and pull manually.
The one rule that will save your vault
Straight from their docs: avoid mixing sync services. Running Obsidian Sync and iCloud on the same vault at once causes conflicts and corruption. Pick one method and only one.
Also worth knowing why free services sometimes misbehave: Obsidian needs access to the whole vault at once — renaming a file means updating every link pointing at it — and partial-download features like OneDrive's Files On-Demand break that. Set your vault to always stay downloaded.
6. The plugin risk nobody mentions
The community ecosystem is enormous — Obsidian reported 4,000+ plugins and themes and 120 million downloads as of May 2026. It's the main reason people stay.
But their own security page is unusually blunt, and it's worth quoting rather than paraphrasing:
"Due to technical limitations, Obsidian cannot reliably restrict plugins to specific permissions or access levels." Community plugins can access files on your computer, connect to the internet, and install additional programs.
Obsidian ships in Restricted Mode by default, which blocks third-party code entirely. Turning it off is a real decision, not a formality.
Two things that make this manageable. Since May 2026 every plugin version is automatically scanned for malware and code-quality issues, and the directory shows a public safety scorecard. And plugins never auto-update — you approve each one.
Practical rule: install plugins one at a time, from the directory, and check the scorecard. If you handle client or sensitive data, be genuinely conservative here.
7. Who it's not for
Skip it if you want zero setup. Obsidian hands you a blank folder and a lot of options. Apple Notes opens and works. That's a real advantage for some people and there's no shame in it.
Skip it if you need live collaboration. Multiplayer editing is on the roadmap, not shipped. If you need two people typing in one doc right now, this isn't it.
Skip it if you'll spend more time theming than writing. The customisation is the trap. Plenty of people have beautiful vaults and no notes.
Use it if you want your notes to outlive the app, you work offline a lot, you're privacy-conscious, or you want an agent to be able to read and write your knowledge base directly. That last one is new, and it's the most interesting thing about Obsidian in 2026.
The one-line version: it's a folder of text files with very good tooling on top. Everything that makes it powerful comes from that, and so does everything that makes it demanding.
Download: obsidian.md/download · Pricing: obsidian.md/pricing. Not affiliated, not an affiliate link — I just use it.
Method note: every price and policy here was read off Obsidian's own pages in August 2026, not from other articles — which is how the removed commercial-licence requirement and the version-history discrepancy turned up. Pricing changes; check before you buy.
Want the next one first?
The Input Daily — a 5-minute AI brief every weekday. 3 stories that matter, 1 tool worth trying, 1 prompt to steal.
Free. Every morning. Unsubscribe in one click. Privacy Policy.
You're all set.
The Input Daily lands in your inbox tomorrow morning. While you're here — the rest of the guides are free too.
Browse all free guides →