What is Obsidian, and should a real estate business run on it?
Written for agents, brokers, lenders, contractors, home services.
The short answer
Obsidian is a reader and editor for a folder of plain text files sitting on your own computer. The folder is called a vault, and it is an ordinary folder you could open in Finder.
It is very good at one file per person, one folder per transaction, links between them, and instant search over your own sentences. Those files stay readable with the app uninstalled.
It is a text editor over a folder, so it enforces nothing and files nothing. It will hold two contradictory notes about the same closing forever and never mention it.
Nothing fills it. That is the reason most vaults are abandoned inside a month, and it is a question about your system rather than a question about the app.
Verdict: keep it as the window onto records you already own. Do not expect it to be the thing that writes them.
Obsidian comes up in agent groups and mastermind calls about once a quarter. Somebody calls it a second brain, somebody else installs it that night, and three weeks later the folder holds four notes and one of them is a grocery list. That is not the software failing. That is what happens when a tool doing one narrow thing gets described as a tool that runs your business.
We use Obsidian. We also think most people who install it have been sold the wrong idea of what it is.
What is Obsidian?
Obsidian is a reader and editor for a folder of plain text files stored on your own computer, and the folder it points at is called a vault.
There is no database underneath it. Open the vault in Finder or File Explorer and you see ordinary files ending in .md, which is markdown, which is plain text with a few punctuation marks that mean heading, bold and list. Uninstall the app this afternoon and every file is still sitting there, still readable in the most basic text editor on the machine.
A vault is a folder. Any folder on your disk becomes one the moment you point Obsidian at it, and the app writes a single hidden directory called .obsidian inside to hold your settings. That is the whole relationship between the app and your records.
Pointed at a folder of records you already keep, Obsidian is a better window onto the same files. It does not convert them, import them or take ownership of them. That matters more than any feature on the product page.
What does Obsidian do that a folder of Word documents does not?
Three things, worth naming separately because only one of them gets talked about.
- Search across everything you have ever written, instantly. Type a street name and every file mentioning it appears. Your CRM searches the fields it was built with. Obsidian searches your sentences.
- Wikilinks. Put two square brackets around a name and it becomes a link. Write [[Maria-Ortega]] inside a transaction note and the name is clickable, and if no file exists for her yet, clicking it creates one. (This one is an illustration rather than a client.)
- Backlinks. Open a person file and Obsidian lists every other file linking to it. Open the file for the lender you refer buyers to and you see the six transactions where you mentioned him, without ever having maintained a list of them.
The third one is why the tool has a following. You get an index of relationships without building an index. The catch is that it only shows relationships you wrote down in the first place.
Where do the files live, and do you need Obsidian Sync?
Do you need to pay for Obsidian Sync?
Obsidian Sync is a paid subscription add-on that copies a vault between your own devices, and it is optional, because a vault is a folder and any file sync service you already pay for will move that folder.
On a call on 2026-08-07 we installed Obsidian with an agent who had never used it and put the vault folder inside her Google Drive folder. That works. It also puts you in the same position as any shared document: if two devices edit the same file before the folder finishes syncing, you get a conflicted copy sitting next to the original, and nothing in Obsidian will tell you which one is right.
The paid sync was built for that case and keeps its own version history. Whether it earns a subscription depends on whether you edit from a phone in the car between showings, which most agents do. Prices change, so read the vendor page before you budget it.
What is Obsidian genuinely good at for a real estate business?
Four jobs, all the same shape: your own words about your own people, kept somewhere you control.
- One file per person that survives everything else changing. Over a career you will change brokerage, CRM, phone and email address. A markdown file named Maria-Ortega.md survives all four. A notes field inside a platform your brokerage pays for does not, and an export usually hands back names, emails and stages while the sentence you cared about arrives truncated or missing.
- One folder per transaction. The deal file, the call notes, the small documents that belong to it. When it closes, that folder is the record of what happened and it stops depending on the platform that produced it.
- Linking a person to a deal to a property. Those three things are what a real estate business tracks. Wikilinks let one note sit in all three places without being copied into all three, which is what stops the copies from disagreeing later.
- Search over your own sentences. Six months from now somebody asks who you know for foundation work near a particular neighborhood. Search finds the note you wrote after a job walk. No CRM field was ever going to hold that.
What is Obsidian bad at?
Obsidian is a text editor over a folder. Read that twice, because everything below follows from it.
- It enforces nothing. No required fields, no validation, no rules. Nothing stops you writing the same client name three ways across three files, and once you have, your wikilinks quietly point at three different people.
- It files nothing for you. An email arrives, a call happens, an addendum gets signed. None of it lands in the vault unless a human opens the app and types.
- It holds contradictions forever without complaint. One note says the appraisal came in at value. Another says it came in short. Both sit there. Nothing flags the pair. A form field would at least have forced one answer.
- It has no idea what is current. A file saying a loan is in underwriting is a sentence somebody typed on a Tuesday. The file does not know it went stale and will never tell you.
Why do most Obsidian vaults get abandoned within a month?
Because nothing fills them. Obsidian reads and edits files and never creates them on its own, so unless something else in the business writes into the folder, the vault only ever holds what one person had time to type by hand.
This is why the tool question and the system question have to be answered separately. Obsidian is a good window. A window does no filing. The two arrangements that keep a vault alive are a person with a real daily habit, which is rare in a transaction week, or something automatic writing into the folder.
On the automatic side: an AI assistant that can read and write files on your own computer can be pointed at the same folder, writing new files in the shape you specified and updating the index when it adds one. Obsidian then becomes how you read the results rather than how you produce them.
Is an installed app the same as an installed system?
On 2026-08-12 we audited a Mac where Obsidian was installed. We searched for .obsidian directories across the vault folder, the Desktop, Downloads, three connected cloud storage accounts and an external drive, six directory levels deep. We found zero.
The conclusion we recorded was: "I could not find an Obsidian vault in the places I could look. I am not saying he does not have one." Absence of a result in the places we could reach is not proof of absence everywhere, and a report claiming otherwise is worse than no report at all.
Two things follow. The app being installed tells you nothing about whether a system exists behind it. And a vault is a folder whose location nothing records unless you record it. Obsidian remembers where it is, inside its own settings. You do not, and neither does whoever has to find it in five years.
The fix costs one file. Write down which service and which named folder holds each kind of thing: listing photo sets in Dropbox, signed contracts in the transaction system, the vault in a named folder on the laptop. A service name and a folder name travel between a Mac and a PC. A file path does not.
Should a whole team standardize on Obsidian?
On 2026-08-07 a team of agents was recorded deciding to centralize on "a second brain system using Obsidian" and to adopt a shared structure across the team. Be straight about the source: that came from a meeting notetaker's machine-generated summary rather than a first-hand account, so read it as a decision somebody made and not as a case study with results attached.
If you are weighing the same move, answer three questions before copying anyone's folder structure. Who writes into it. What forces a file to exist, so the whole thing does not rest on one person's discipline. And what happens when two people open the same client file in a shared folder at once. Obsidian has no answer to the third, which is the fourth box below.
How would you set this up for a real estate business?
The arrangement we run is three folders and one instruction file. It is called PAD, for People, Assets, Deals, and the whole design fits in a paragraph each.
- 01People. One file per human, named First-Last.md, forever. Past clients, the lenders you send buyers to, the roofer, the title officer, the referral source who has sent you four deals in nine years. What you know about them lives in their file and nowhere else.
- 02Assets. Things that appreciate or decay depending on whether somebody maintains them. Your website, your database, a rental you own, your license renewal, the truck.
- 03Deals. One folder per transaction, holding the deal file plus calls, documents and decisions, sorted into potential, active and closed. A deal has someone on the other side of it, which is the test that keeps this folder from swallowing everything.
- 04An operating file. A plain markdown file at the top named CLAUDE.md that tells an AI assistant how to work inside those folders: where to file what, how to name things, what it may never do. It is written in English, you can edit it in the same editor as everything else, and it is the difference between a folder and a system.
Obsidian sits on top of that folder as the reading and editing surface. The assistant does the filing. One rule from the operating file is worth stealing whatever you use: a promise you made gets written on the file of the person you made it to, and nowhere else. Two copies means two truths, and one of them goes stale without announcing it.
The four boxes
Filled in for Obsidian, for a real estate, lending or trades business, as of 2026-07-11. If you use it daily and disagree with the fourth box, that is the disagreement worth having.
There, and should be
Reading, editing, linking and searching a folder of your own records that already sits on your own computer.
- Backlinks hand you a relationship index you never had to build or maintain.
- The files stay readable with the app uninstalled, so the cost of leaving is close to zero. That is rare in this category and it is the strongest thing about the product.
- Cheap for a solo operator. Free for personal use at the time of writing, with sync sold separately, and pricing terms for commercial use change, so check the vendor page.
Missing, and should be there
Something that writes into the vault when you are not sitting there typing.
- Every dead vault we have looked at died from a filling problem rather than a reading problem.
- Write the gap as a job first: what should exist in the folder after a listing appointment, a closing or a referral call, and what puts it there.
- The three candidates are a genuine daily habit, an assistant with file access to the folder, or a routine that exports from wherever the record already lives.
There, and should not be
A vault holding live numbers, and a second vault nobody remembers making.
- A price, a loan status, a closing date or a lockbox code typed into a note is stale the moment the real system changes. The note should name where to look instead of holding the number.
- Two vaults is the expensive failure, the same as two CRMs: two answers to one question, and neither one announces that it went stale.
- Plugin sprawl. Community plugins are third-party code with read and write access to a folder of client information. Install few and know who wrote them.
Missing, and correctly missing
No permissions model, no multi-user record locking, and no server.
- For a records store owned by one person, this is the right call. Permissions exist to answer the question "who may see this". When the answer is always the owner, the machinery is overhead and one more thing to misconfigure.
- No server also means no vendor outage, no account lockout, no forced migration and no pricing change that holds nine years of client notes hostage. Your records survive the company.
- The cost is specific. A five person team sharing a vault in a cloud folder has no record locking, so two people editing one client file at once produce a conflicted copy, and the newer save can win quietly. Nothing warns anyone.
- The condition that flips this: the day a second person is expected to write into the same client records daily. At that point something with a server starts being the right answer for the shared part, and the vault stays for what one person owns.
If you take one thing from this: install the app if you want to, it takes twenty minutes. Decide first what is going to put files in the folder. That answer is the system, and the app is the window you read it through.
Common questions
- What is Obsidian?
- Obsidian is a reader and editor for a folder of plain text markdown files stored on your own computer. The folder is called a vault, it is an ordinary folder you can open in Finder or File Explorer, and the files stay readable if you uninstall the app.
- Is Obsidian free, and what does Obsidian Sync cost?
- Obsidian is free for personal use, and Obsidian Sync, which copies a vault between your own devices, is a paid subscription add-on. Sync is optional, because a vault is a normal folder and any file sync service you already pay for will move it. Commercial use terms and prices change, so check the vendor pricing page before budgeting it for a team.
- Where is my Obsidian vault stored?
- Wherever you put it. A vault is a normal folder on your disk, chosen by you when you create it, and the app writes a hidden .obsidian directory inside it for settings. On 2026-08-12 we audited a Mac where Obsidian was installed, searching the vault folder, Desktop, Downloads, three cloud storage accounts and an external drive six levels deep for .obsidian directories, and found none. That is why the folder location belongs written down in a file rather than held in memory.
- Can Obsidian replace a real estate CRM?
- No, for one specific reason: a CRM does work on a schedule and Obsidian does not. No drip campaigns, no reminders that fire, no lead routing, no dialer. Obsidian holds what you know about a person. Businesses running both keep the durable knowledge in files they own and let the CRM do the sending.
- Why do Obsidian vaults get abandoned?
- Because nothing fills them. Obsidian reads and edits files and never creates them on its own. Unless a person types into it every day or something automatic writes into the folder, the vault only holds what somebody found time to enter by hand, which during a busy closing week is nothing.
Worth passing along
This one serves an agent and a contractor, for different reasons that turn out to be the same problem. The agent needs one file per past client that survives her next brokerage move and the CRM that goes with it. The contractor needs every promise made to a homeowner to live somewhere other than three phones and the glovebox of a truck. Both are a folder of text files plus something that writes into it, so this travels between them.
Written by Brett K Moore. We build the PAD System, a records structure for people, assets and deals that lives as plain text files on your own computer. Read what it is.
Read next
How do you decide whether a tool belongs in your business?
A four box audit for a software stack: what is there and should be, what is missing and should be there, what is there and should go, and what is missing for good reason. Written for real estate agents, brokers, mortgage lenders and the trades who work alongside them.
Why should your client records be plain text files?
Underneath the argument about which app to use is a quieter question about the file format your records are written in. What plain text gives an agent, a lender or a contractor, what version control does and does not protect, and where the files sit. Four box verdict included.
Should Notion be where your business keeps its records?
Notion is very good at shared pages a team reads together. The question is whether it holds your records or shows them. The rule we adopted, the stale page that produced it, and the one case where content is allowed to arrive in Notion first.