I tried a dozen note-taking apps before Obsidian stuck. Here is why, and how to get started.
You have a bunch of markdown files scattered across folders. Maybe they live in Google Drive or Dropbox. Maybe you use iA Writer or Typora. Either way, you hit the wall where searching across files becomes slow and connections between ideas get lost.
Obsidian solves this by turning your folder of markdown files into a searchable, linkable knowledge base. It runs on Electron, so it works on Linux, macOS, and Windows. Your files stay as plain .md files on disk. No proprietary format, no vendor lock-in.
Here are seven things I wish I knew when I started.
1. Links are the whole point
Obsidian uses wiki-style links: [[link text]]. Type two square brackets and a popup shows you files to link to. Click one and you get a clickable link to that note.
This changes how you write. Instead of saying “as discussed in the database migration doc,” you write [[database migration]]. The link works. The connection is explicit. And Obsidian builds a graph of how your notes connect.
You can also create notes that do not exist yet. Type [[something new]], click the link, and Obsidian creates a file for you. No friction between thinking “I should write about this” and writing about it.
2. Tags organize across folders
Folders force hierarchy. One note can live in exactly one folder. Tags do not have that limit.
Use #linux or #security/tools anywhere in a note. Obsidian picks them up and shows you every note with that tag. Nested tags work too: #devops/kubernetes gives you a tag tree.
I tag every tutorial note with the tool name and the category. #linux/cli and #security/scanning. A note can have both. Folders cannot do that.
3. The graph view is not just for show
Open the graph view (Graph View in the left sidebar). You see every note as a dot and every link as a line between dots. Clusters of connected notes show up as dense clouds. Unlinked notes sit alone at the edges.
I use this to find orphans. If a note has no links pointing to it, it is disconnected from my knowledge base. I either link it somewhere or archive it. The graph tells you what you are not connecting.
You can also filter the graph by tags or search terms. Local graph (click a note, show only its neighbors) is more useful day-to-day than the full graph.
4. Plugins add real power
Obsidian comes with a plugin system. Some are core (included by default). Others are community plugins you install from the settings panel.
Here are the ones I actually use:
Daily notes. Hit a hotkey and Obsidian opens or creates a note for today. I log what I worked on, what broke, and what I learned. Over months, this becomes a searchable work journal.
Backlinks. Shows every note that links to the current one. At the bottom of every note, you see a list of backlinks. This is how Obsidian makes you aware of connections you forgot you made.
Kanban. Turns a markdown list into a kanban board. Good for tracking projects inside your notes without leaving the app.
Dataview. Treats your notes as a database. You can write queries like TABLE file.ctime FROM #tutorial SORT file.ctime DESC and get a list of all tutorial notes sorted by creation date. It takes some learning, but once it clicks, it replaces half the manual organization you do.
5. Search with grep and ripgrep
Obsidian has built-in search. It works fine. But if your vault grows past a few hundred notes, you might want something faster.
Your vault is just a folder on disk. You can grep it from the terminal. Or better, use ripgrep to search across all your notes instantly.
rg -t md "api key" ~/vault/
This searches all markdown files in your vault for “api key” in under a second. Combine with fzf for interactive previews.
I keep a terminal open with my vault directory. Quick searches there are faster than opening Obsidian for a lookup.
6. Sync without paying for Obsidian Sync
Obsidian Sync costs money. You do not need it if you use the terminal.
Put your vault in a Git repository. Commit and push when you finish a session. Pull on your other machines. It works on Linux, works over SSH, and costs nothing.
cd ~/vault
git add -A
git commit -m "daily notes update"
git push
I automated this with a cron job that commits every hour. If I lose my laptop, I clone the repo and my notes are back. No proprietary sync server needed.
You can also use syncthing, rsync, or a Dropbox symlink. The important thing is that the files are plain markdown, so any sync tool works.
7. Templates save you from blank page syndrome
Create a Templates folder. Add a note with this structure:
---
tags: [template]
---
# {{title}}
## What is this about?
## What did I learn?
## Next steps
Set Templates as your template folder in Obsidian settings (Core plugins > Templates). Now you can insert this template into any new note with a hotkey. Replace the placeholders with real content.
I have templates for daily logs, project notes, tool tutorials, and meeting notes. Each one prompts me for the things I would forget to write otherwise. The friction of starting a note drops to zero.
Getting started
Download Obsidian from obsidian.md. Create a new vault in an empty folder. Move a few of your existing markdown files into it. Start linking them together with [[double brackets]].
That is enough to be useful on day one. The plugins, the graph, the templates, the Git sync. Add those as you need them. Do not try to set up everything before you start writing.
For more on Obsidian plugins and workflows, check the official documentation and the Obsidian community forum. If you want to search your vault from the terminal, the fzf tutorial we published earlier shows you how to combine fzf with ripgrep for interactive note searching.
The best note-taking system is the one you actually use. Obsidian stays out of your way and lets your notes grow naturally. Give it a week.