Menu
Home Articles About Work With Me
Modern developer workspace with screens showing organized data and code
Technology Apr 3, 2026 • 16 min read

Obsidian: The Free Tool That Turned My AI Research From Chaos Into a Second Brain

From CSV to XML to JSON to YAML to Markdown, humanity has been trying to organize data for decades. AI finally made it personal. Here's why Obsidian is the perfect companion for anyone doing research with AI, and why Markdown is the language that makes it all work.

Share:
Lee Foropoulos

Lee Foropoulos

16 min read

Continue where you left off?
Text size:

Contents

In the spring of 2025, I started a research project using GROK. Research and machine learning weren't new to me. I'd been down that road before. But having a conversation with an AI that had access to every scientific article ever published, every dataset ever collected, every study ever peer-reviewed? That was new. And the absolute mess of not extracting and organizing the output from those conversations? That was a special kind of new hell.

I'd asked GROK to explain where we are with quantum computers and he brought back everything on decoherence. So naturally I looked at exactly every piece of what was happening down to the metal. Qubit stability. Error correction thresholds. Topological approaches. Cryogenic cooling requirements. Then I started researching ways to fix decoherence. Not mitigate it. Fix it. GROK came back with 3,000 words on quantum error correction codes. Then another 2,000 on surface code architectures. Then superconducting transmon qubits. Then photonic approaches. Then trapped ion comparisons. Each response was brilliant. The collection was chaos. I had forty browser tabs, six Google Docs, a Notes app that looked like a crime scene, and a growing sense that I was losing information faster than I was gathering it.

I needed a system. Not a filing cabinet. A second brain.

The problem with AI research isn't getting answers. It's that AI gives you so many good answers, so fast, that your organizational system collapses under the weight of its own brilliance.

Enter Obsidian. Free. Local. Markdown-based. And, as it turns out, the perfect companion for anyone doing serious work with AI.

But before I explain why Obsidian changed everything, we need to talk about the language it speaks. Because the reason Obsidian works so well with AI isn't the app itself. It's Markdown. And the reason Markdown matters is a story about humanity's long, occasionally hilarious struggle to organize information.

Free
Obsidian costs exactly nothing for personal use. The core app, the plugin ecosystem, and local storage are all free. Sync and publish are paid extras, but the tool itself? Zero dollars. Forever.

What Is Markdown (And Why Should You Care)?

Markdown is a lightweight way to format text using plain characters. No menus. No toolbars. No clicking "Bold" and hoping the formatting doesn't break when you paste it somewhere else. You type **bold** and it becomes bold. You type # Heading and it becomes a heading. You type - item and it becomes a bullet point.

That's it. That's the whole trick.

John Gruber and Aaron Swartz created Markdown in 2004 with a specific philosophy: the raw text should be readable even without rendering. If you open a Markdown file in Notepad, it still makes sense. Try that with an HTML file or a Word document. You'll get angle brackets and XML gibberish that looks like someone's cat walked across the keyboard during a firmware update.

Modern workspace with clean desk setup showing organized notes and screens
This is what organized thinking looks like. Or at least what it looks like before your forty-seventh GROK conversation.

Here's what makes Markdown special:

  • It's portable. A .md file works everywhere. Mac, Windows, Linux, your phone, your grandmother's tablet. No vendor lock-in. No proprietary format. No "please upgrade to Premium to open this file."
  • It's future-proof. Markdown files from 2004 open perfectly today. Try opening a WordPerfect document from 1994. Actually, don't. It's painful.
  • It's version-control friendly. Git tracks changes in Markdown beautifully. Every edit, every addition, every deletion is visible in the diff. This is why developers write documentation in Markdown, why GitHub renders it natively, and why every README file on earth is a .md file.
  • AI speaks it fluently. Every major AI model outputs Markdown by default. ChatGPT, Claude, GROK, Gemini: they all format their responses in Markdown. Headers, bold text, code blocks, lists, tables. When you paste AI output into a Markdown editor, it arrives already formatted. No cleanup. No reformatting. It just works.
  • You're reading it right now. This very article was written in Markdown. The headings, the bold text, the bullet points, the callout boxes, the image captions, all of it. A plain .md file, processed by a build system, rendered into the page in front of you. Every post on this blog starts as Markdown. It's Markdown all the way down.

Markdown in 30 Seconds

# Heading 1 — Big heading ## Heading 2 — Smaller heading **bold**bold text *italic*italic text - item — bullet point [link text](url) — clickable link ![alt](image-url) — embedded image `code` — inline code > quote — blockquote

That's 90% of what you'll ever need. The learning curve is about four minutes.

A Brief, Mildly Painful History of Humans Organizing Data

The story of Markdown makes more sense when you see the timeline of humanity trying (and mostly failing) to organize information in machines. It's a story of good intentions, bad formatting, and increasingly angry developers.

CSV (Comma-Separated Values), 1970s. The original. Rows and columns, separated by commas. Dead simple. Also dead limited. CSV has no concept of hierarchy, no data types, no way to express relationships. It's a spreadsheet in a trench coat pretending to be a database. We still use it constantly because sometimes all you need is a list of things, and CSV does lists like nobody's business.

XML (eXtensible Markup Language), 1998. The enterprise answer to "CSV isn't complicated enough." XML introduced hierarchy, self-describing tags, and the ability to validate structure. It also introduced the experience of opening a configuration file and seeing more angle brackets than actual data. XML was the language of SOAP APIs, RSS feeds, and corporate suffering. If your company ran on Java in 2006, your nightmares were in XML.

1998
the year XML was released. By 2005, developers were already plotting its replacement. The tags were verbose, the parsers were slow, and the ratio of markup to actual content often approached 3:1.

JSON (JavaScript Object Notation), 2001. Douglas Crockford looked at XML and essentially said "what if we didn't do all of that?" JSON uses curly braces, square brackets, and colons. It's readable, lightweight, and maps directly to how programming languages already represent data. JSON killed XML for web APIs so thoroughly that bringing up SOAP at a tech conference now gets the same reaction as recommending bloodletting at a medical symposium.

YAML (YAML Ain't Markup Language), 2001. YAML took JSON's simplicity and asked: "What if we removed the braces too?" YAML uses indentation instead of brackets, which makes it beautifully readable and also means that a single misplaced space can break your entire Kubernetes deployment at 3 AM. YAML is the language of configuration files, CI/CD pipelines, and DevOps engineers who've developed an unhealthy relationship with whitespace.

CSV is a list. XML is a novel with footnotes. JSON is a conversation. YAML is a poem. Markdown is a letter to a friend. Each one solved a real problem. Only one of them was designed for humans first.

Markdown (2004). And then Gruber and Swartz asked the question nobody else had bothered with: "What if the format was designed for humans to read and write, not just machines to parse?" Markdown isn't a data serialization format like JSON or YAML. It's a writing format. It's for thoughts, notes, documentation, articles, research, and conversations. It's what happens when you optimize for the person at the keyboard instead of the server in the rack.

Clean typography and design elements arranged in a modern creative layout
From CSV to Markdown: fifty years of humanity trying to make machines understand how we think. Markdown is the first format that bothered to work the other way around.

Why AI Loves Markdown (And Why That Matters for You)

Here's the thing that changed everything for my research workflow: AI models don't just support Markdown. They think in it.

When you ask Claude, ChatGPT, GROK, or Gemini a complex question, the response comes back structured in Markdown. Headers organize the sections. Bold text emphasizes key points. Code blocks wrap technical content. Tables present comparisons. Lists break down steps. The AI isn't doing this because someone told it to be pretty. It's doing it because Markdown is the most efficient way to express structured thought in plain text, and these models were trained on millions of documents that use it.

This means that when you copy an AI response into Obsidian, it arrives already formatted. The headers become headers. The bold stays bold. The links work. The code blocks render. There's no cleanup step. No reformatting. No "paste as plain text and then manually re-bold everything." The AI wrote Markdown. Obsidian reads Markdown. They're speaking the same language.

100%
of major AI models (Claude, ChatGPT, GROK, Gemini, Llama) output Markdown by default. When your note-taking app also speaks Markdown natively, the friction between 'getting the answer' and 'organizing the answer' drops to zero.

And this is where the magic happens. Because Obsidian isn't just a Markdown editor. It's a knowledge graph. Every note can link to every other note using [[double brackets]]. When you're researching a topic across dozens of AI conversations, those links become a web of connected ideas. Your note on dopamine receptors links to your note on habit formation, which links to your note on circadian rhythms, which links to your note on cortisol, which links back to dopamine receptors. The connections become visible. Patterns emerge that you didn't plan. Your research develops its own structure.

That's why I call it a second brain. It's not a filing cabinet. It's a nervous system.

What Obsidian Actually Does (And Why It's Different)

Obsidian is a free, local-first Markdown editor that turns your notes into a connected knowledge base. Let me unpack what each of those words means, because every one of them matters.

Free. The core app costs nothing. Not "free with ads." Not "free trial for 14 days." Not "free tier with crippled features." Free. The plugin ecosystem is free. Local storage is free. You can use Obsidian for years without ever spending a dollar. The paid options are Sync ($4/month for cross-device syncing) and Publish ($8/month for hosting your notes as a website). Both are optional. The app itself is completely free.

Local-first. Your notes live on your device as plain .md files in a regular folder. Not on someone's cloud server. Not behind a login wall. Not in a proprietary database. They're files. On your computer. You can open them in any text editor, back them up however you want, version-control them with Git, and access them even if Obsidian goes out of business tomorrow (it won't, but the point stands). Your data is yours. Fully. Permanently.

Connected knowledge base. This is the killer feature. Every note can link to every other note with [[WikiLinks]]. Obsidian builds a graph view showing how all your notes relate to each other. When you're doing research across multiple topics, this graph becomes a map of your thinking. Clusters form around themes you didn't consciously organize. Orphan notes reveal gaps in your understanding. The graph isn't just pretty (though it is). It's diagnostic.

What You Get for Free

Core features (all free):

  • Unlimited notes and vaults
  • Bidirectional linking with [[WikiLinks]]
  • Graph view of all connections
  • Full-text search across everything
  • Split panes and workspaces
  • 1,800+ community plugins
  • Custom themes and CSS
  • Canvas (infinite whiteboard)
  • Outline view, backlinks panel, tag management
  • PDF export, file embedding, transclusion
  • Daily notes, templates, quick switcher
  • Works offline, no internet required

Paid options:

  • Sync ($4/mo): End-to-end encrypted sync across devices
  • Publish ($8/mo): Turn your vault into a website
  • Catalyst (one-time): Early access to new features + support development

Full disclosure: I personally use the Sync plan because I work across multiple devices and need my research available everywhere. I'm also a Catalyst supporter because the team behind Obsidian is building something genuinely important, and they deserve the backing. But you absolutely do not need either of these to get massive value from the tool.

Art gallery exhibition with carefully organized visual elements in a modern space
Your Obsidian vault is a gallery of your own thinking. Every note is an exhibit. Every link is a corridor between ideas. The graph view is the floor plan.

Collaboration and the Vault System

Obsidian's vault system makes collaboration surprisingly natural. A vault is just a folder. Share the folder (via Dropbox, Google Drive, iCloud, Git, or Obsidian Sync) and everyone has the same set of notes, the same links, the same graph. There's no "shared workspace" abstraction. No permissions matrix. No "who has edit access?" headache. It's files in a folder. Anyone with access to the folder has access to the knowledge base.

For team research, this is transformative. I've seen teams use shared vaults for:

  • Research projects where each team member owns a topic but everyone's notes interlink
  • Meeting notes that link to project pages, decisions, and action items
  • Documentation that lives alongside the code it describes
  • Editorial workflows where writers draft in Markdown and editors comment inline

The Plugin Ecosystem (This Is Where It Gets Wild)

Obsidian's community plugin ecosystem is staggering. Over 1,800 plugins built by the community, all free. Here are the ones that actually matter:

Essential Plugins

Dataview — The SQL of your notes. Query your vault like a database. "Show me all notes tagged #research created this week" becomes a live, auto-updating table. This alone is worth the installation.

Templater — Advanced templates with logic, dates, prompts, and dynamic content. Create a template for "AI Research Session" that auto-fills the date, topic, and links to related notes.

Excalidraw — A full drawing and diagramming tool inside Obsidian. Whiteboards, flowcharts, concept maps, architecture diagrams. All stored as Markdown-compatible files.

Calendar — Visual calendar that links to your daily notes. See your research timeline at a glance.

Kanban — Turn any note into a Kanban board. Track research tasks, article drafts, review stages.

Advanced Tables — Makes editing Markdown tables actually pleasant. Tab through cells, sort columns, align content.

Obsidian Git — Automatic Git backup and sync. Version control your entire vault with zero effort.

Copilot — AI assistant inside Obsidian. Chat with AI about your notes. Summarize, expand, connect ideas.

Linter — Auto-format your Markdown. Consistent headings, spacing, and style across your entire vault.

Natural Language Dates — Type "next Friday" and it becomes a proper date link. Small quality-of-life feature that saves surprising amounts of time.

1,800+ community plugins. All free. Built by people who use Obsidian for their own research, writing, development, and thinking. The plugin ecosystem is what turns a good Markdown editor into a custom-built knowledge operating system.
1,800+
free community plugins available for Obsidian. From AI integration to Kanban boards to full drawing tools, the plugin ecosystem turns a simple note editor into whatever you need it to be.

The CLI (And Why Automation People Should Be Excited)

Obsidian now includes a command-line interface. If that sentence doesn't mean much to you, here's why it matters: a CLI means that scripts, automation tools, and AI agents can interact with your vault programmatically. Not through the GUI. Not by simulating mouse clicks. Through direct, scriptable commands.

This is enormous for agentic collaboration. Imagine an AI agent that monitors a data feed, summarizes new findings, creates a note in your vault, links it to related research, and tags it for review. All without you opening the app. Imagine a CI/CD pipeline that updates your project documentation vault every time code ships. Imagine a cron job that pulls your daily calendar, creates a daily note template, and pre-populates it with relevant links from yesterday's work.

The CLI turns Obsidian from a tool you use into a tool that works for you, even when you're not looking at it. For anyone building agentic workflows, research pipelines, or automated knowledge management, this is the feature that makes Obsidian a platform rather than just an app.

Obsidian and Jupyter Notebooks (Yes, Really)

For anyone doing data science, machine learning, or technical research, Obsidian plays remarkably well with Jupyter notebooks. The Jupyter plugin lets you run code cells directly inside Obsidian. Python, R, Julia, whatever kernel you have installed. Your research notes and your executable code live in the same vault, linked to the same knowledge graph.

This means you can write a note about a statistical method, link it to your AI conversation about the dataset, and have a live Jupyter notebook running the actual analysis, all inside the same tool. The note-taking, the research, and the computation converge. I've watched data scientists switch to this workflow and physically refuse to go back.

Even without the plugin, Obsidian's code block support means you can embed code snippets directly in your research notes with full syntax highlighting. Document your process as you go. Future-you will be grateful. Present-you always thinks you'll remember what that regex does. Present-you is wrong.

Modern gallery space with carefully curated exhibits and clean visual design
The line between note-taking and computing is disappearing. Obsidian is where it vanishes entirely.

How to Get Started (Right Now, For Free)

Here's the five-minute version:

  1. Download Obsidian from obsidian.md. It runs on Mac, Windows, Linux, iOS, and Android.
  2. Create a vault. A vault is just a folder. Call it "Research" or "Second Brain" or "The Knowledge Dungeon." Whatever motivates you.
  3. Make your first note. Hit Cmd/Ctrl+N. Type a heading with #. Write a thought. Save.
  4. Make a second note and link them. Type [[ and start typing the first note's name. Obsidian auto-completes. You've just created your first knowledge link.
  5. Open the Graph View. Hit Cmd/Ctrl+G. See your two notes connected. Now imagine five hundred notes, all linked by topic, date, project, and theme. That's what's coming.
  6. Install a plugin. Go to Settings > Community Plugins > Browse. Start with Dataview and Calendar. The addiction begins here.
  7. Paste an AI conversation. Copy the output from your next Claude, ChatGPT, or GROK session directly into Obsidian. Watch the Markdown render perfectly. Feel the satisfaction.

"The best time to start a knowledge management system was five years ago. The second best time is right now, before your next AI conversation generates another 2,000 words of insight that disappears into a browser tab you'll never find again."

Pro Tip: The AI Research Workflow

Here's the workflow I use every day:

  1. Start a research session in Claude, GROK, or ChatGPT
  2. Copy the output directly into a new Obsidian note
  3. Add [[links]] to related notes in my vault
  4. Tag it with relevant topics (#neuroscience, #habits, #research)
  5. Let Dataview auto-generate index pages by tag and date
  6. Watch the graph grow. Watch patterns emerge. Watch your second brain develop its own structure.

Total overhead: about 30 seconds per conversation. Return on investment: a searchable, linked, permanent record of every insight you've ever gathered.

Why This Matters More Than You Think

We're at a strange inflection point. AI can generate more insight in an hour than a research team used to produce in a month. The bottleneck isn't intelligence anymore. It isn't access. It's organization. The people who thrive in the next decade won't be the ones who can prompt the best answers. They'll be the ones who can capture, connect, and retrieve those answers when they need them.

Obsidian is free. Markdown is universal. AI speaks both fluently. The toolchain is sitting right there, waiting for you to plug it in.

I started with a mess of browser tabs and a Notes app that looked like a crime scene. I now have a vault with over a thousand linked notes, organized by topic, cross-referenced by AI conversation, and searchable in milliseconds. It took one afternoon to set up and thirty seconds per session to maintain.

The tool is free. The format is future-proof. The AI already speaks the language. The only question is whether you start today or wait until your next forty browser tabs convince you the hard way.

Your Obsidian Starter Checklist 0/7
How was this article?

Share

Link copied to clipboard!

You Might Also Like

Lee Foropoulos

Lee Foropoulos

Business Development Lead at Lookatmedia, fractional executive, and founder of gotHABITS.

🔔

Never Miss a Post

Get notified when new articles are published. No email required.

You will see a banner on the site when a new post is published, plus a browser notification if you allow it.

Browser notifications only. No spam, no email.