# Obsidian for Complete Beginners

A practical guide to understanding and using Obsidian — written for someone who has never used a personal knowledge management app before.

---

## Table of Contents

1. [The Big Picture](#the-big-picture)
2. [Key Terms (Plain English)](#key-terms-plain-english)
3. [Installing Obsidian](#installing-obsidian)
4. [Your First Vault](#your-first-vault)
5. [Creating and Editing Notes](#creating-and-editing-notes)
6. [Linking Notes Together](#linking-notes-together)
7. [Organizing Your Notes](#organizing-your-notes)
8. [Finding Things](#finding-things)
9. [The Graph View](#the-graph-view)
10. [Daily Notes and Templates](#daily-notes-and-templates)
11. [Backlinks and the Local Graph](#backlinks-and-the-local-graph)
12. [Settings Worth Changing Early](#settings-worth-changing-early)
13. [Syncing Across Devices](#syncing-across-devices)
14. [Plugins (When You Are Ready)](#plugins-when-you-are-ready)
15. [Obsidian vs. Other Note Apps](#obsidian-vs-other-note-apps)
16. [A Simple System to Get Started](#a-simple-system-to-get-started)
17. [Common Mistakes and How to Avoid Them](#common-mistakes-and-how-to-avoid-them)
18. [Quick Reference Cheat Sheet](#quick-reference-cheat-sheet)
19. [Glossary](#glossary)

---

## The Big Picture

### What problem does Obsidian solve?

Most note apps treat each note as an island. You write something in Apple Notes or Google Keep, and it sits there alone. You might forget it exists. You cannot easily see how your ideas connect.

**Obsidian** is a note-taking app built around one idea: **your notes should link to each other like pages on Wikipedia**, forming a web of knowledge you can browse, search, and grow over time.

It is designed for:

- **Personal knowledge** — things you learn and want to remember
- **Connected thinking** — seeing relationships between ideas
- **Long-term reference** — notes that stay useful for years
- **Writing projects** — books, research, documentation
- **Daily journaling** — capturing thoughts day by day

### The library analogy

| Real world | Obsidian equivalent |
|---|---|
| A library building | A **vault** |
| A book on a shelf | A **note** (one `.md` file) |
| A "see also" reference in a book's index | A **link** between notes |
| The card catalog showing which books reference each other | The **graph view** |
| A bookmark | A **tag** |
| A filing cabinet drawer | A **folder** |

### What makes Obsidian different

1. **Your files live on your computer** — not locked in a company's cloud. Each note is a plain text file you can open with any editor.
2. **Links are first-class** — connecting notes is as easy as typing `[[`.
3. **It works offline** — no internet required.
4. **It scales** — from 10 notes to 10,000 without slowing down.
5. **It is free** for personal use (with optional paid sync and publish features).

---

## Key Terms (Plain English)

### Vault
Your entire collection of notes. A vault is just a folder on your computer (or phone) that Obsidian watches. Everything — notes, attachments, settings — lives inside it.

### Note
A single document, saved as a `.md` (Markdown) text file. Notes can contain text, headings, lists, links, images, and more.

### Markdown
A simple way to format text using plain characters. You type `# Heading` instead of clicking a "Heading" button. Obsidian shows a live preview as you write.

### Wikilink
Obsidian's special link format: `[[Note Title]]`. Click it to jump to that note. If the note does not exist yet, Obsidian creates it when you click.

### Tag
A label you attach to notes using `#tag-name`. Tags cut across folders — one note can have multiple tags.

### Backlink
When Note A links to Note B, Note B shows Note A in its **backlinks** panel — "who is pointing to me?"

### Graph
A visual map of all your notes (dots) and links (lines). Useful for discovering connections you forgot about.

### Plugin
An optional add-on that extends Obsidian's features. The core app is powerful on its own; plugins are for when you want more.

---

## Installing Obsidian

### Desktop (Mac, Windows, Linux)

1. Go to [obsidian.md](https://obsidian.md)
2. Click **Download**
3. Install the app like any other application
4. Open Obsidian

### Mobile (iOS, Android)

Search "Obsidian" in the App Store or Google Play Store and install it.

### First launch

Obsidian will ask you to either:
- **Create a new vault** — start fresh
- **Open folder as vault** — use an existing folder of notes
- **Open vault from Obsidian Sync** — if you use their paid sync service

For your first time, choose **Create a new vault**.

---

## Your First Vault

### Creating a vault

1. Click **Create new vault**
2. **Vault name** — something like `My Notes` or `Knowledge Base`
3. **Location** — choose where on your computer to store it
   - On Mac with iCloud: you can put it in your iCloud Drive folder so it syncs via iCloud automatically
   - Example: `/Users/yourname/Library/Mobile Documents/com~apple~CloudDocs/MyVault`
4. Click **Create**

Obsidian opens your empty vault. You will see a sidebar on the left (file explorer), a main editing area, and optionally a right sidebar.

### Understanding the vault folder

If you look at the vault folder in Finder or File Explorer, you will see:

```
MyVault/
├── Welcome.md              ← your first note
├── .obsidian/              ← settings (don't edit manually)
│   ├── plugins/
│   └── ...
└── (your notes go here)
```

Every note you create appears as a `.md` file in this folder. That is the beauty of Obsidian — **you own your data**.

---

## Creating and Editing Notes

### Make a new note

**Method 1:** Click the **New note** icon (paper with pencil) in the left sidebar

**Method 2:** Press `Cmd+N` (Mac) or `Ctrl+N` (Windows)

**Method 3:** Use the Command Palette: `Cmd+P` / `Ctrl+P`, type "new note", press Enter

### Write in your note

Obsidian uses Markdown. Here are the basics:

```markdown
# Main Heading
## Sub Heading
### Smaller Heading

Regular paragraph text. You can write **bold**, *italic*, and ~~strikethrough~~ text.

- Bullet point one
- Bullet point two
  - Nested bullet

1. Numbered list
2. Second item

- [ ] Unchecked task
- [x] Completed task

> A blockquote for callouts or quotes

`inline code`

---
Horizontal rule (divider)
```

### Live Preview vs. Source Mode

Obsidian has two editing modes:

- **Live Preview** (default) — you see formatted text as you type. Recommended for beginners.
- **Source Mode** — you see the raw Markdown characters. Useful when formatting gets confusing.

Toggle with the book icon in the top-right of the editor, or `Cmd+E` / `Ctrl+E`.

### Rename and delete notes

- **Rename:** Right-click the note in the sidebar → **Rename**, or click the note title at the top of the editor
- **Delete:** Right-click → **Delete**, or move the file to trash from your file manager

Renaming a note automatically updates all `[[links]]` pointing to it — one of Obsidian's best features.

---

## Linking Notes Together

Links are the heart of Obsidian. This is what makes it more than a pile of text files.

### Basic links

Type `[[` and Obsidian shows a dropdown of your existing notes. Select one or keep typing a new name:

```markdown
I learned about this in [[Meeting Notes - Aug 21]].

Related concept: [[Version Control Basics]]
```

Click any link to jump to that note instantly.

### Links with custom display text

```markdown
Read more about [[github-for-beginners|GitHub for beginners]].
```

This shows "GitHub for beginners" as the clickable text but links to the note titled `github-for-beginners`.

### Links to headings inside a note

```markdown
See the [[github-for-beginners#Setting Up|setup section]] of the GitHub guide.
```

This jumps directly to a specific heading within a note.

### Creating notes through links

If you type `[[A Note That Does Not Exist Yet]]` and click it, Obsidian creates that note for you. This is called **emergent structure** — your knowledge network grows organically as you write.

---

## Organizing Your Notes

There is no single "right" way to organize. Here are the main tools, from simplest to most flexible:

### Folders

Just like folders on your computer. Drag notes into folders in the sidebar.

```
MyVault/
├── Projects/
│   ├── Website Redesign.md
│   └── Book Draft.md
├── Reference/
│   ├── GitHub Guide.md
│   └── Obsidian Guide.md
└── Journal/
    └── 2026-08-21.md
```

**Good for:** broad categories, separating personal vs. work, project groupings.

**Limitation:** A note can only live in one folder at a time.

### Tags

Add anywhere in a note:

```markdown
#project/website #status/active #topic/git
```

Tags can be nested with `/` for hierarchy: `#project/website`, `#project/book`.

**Good for:** cross-cutting themes, status tracking, topics that span multiple folders.

**Find tagged notes:** Click a tag in the **Tags** pane (right sidebar), or search `tag:#project/website`.

### Links (the Obsidian way)

Instead of filing a note in a folder, you connect it to related notes via links. Organization emerges from relationships rather than rigid categories.

Many experienced users rely primarily on links and search, using folders lightly.

### Maps of Content (MOCs)

A MOC is a note that links to many related notes — like a table of contents you write yourself:

```markdown
# Programming Learning

## Foundations
- [[What is a Variable]]
- [[How Functions Work]]
- [[Git Basics]]

## Projects
- [[Build a Todo App]]
- [[Personal Website]]
```

Create a MOC when you have a cluster of related notes and want a landing page.

---

## Finding Things

### Quick Switcher

Press `Cmd+O` / `Ctrl+O` to open the Quick Switcher — start typing a note name and jump to it instantly. This is the fastest way to navigate once you have many notes.

### Search

Press `Cmd+Shift+F` / `Ctrl+Shift+F` for global search across all notes.

Search supports powerful operators:

| Query | Finds |
|---|---|
| `gitHub` | Notes containing "gitHub" |
| `"exact phrase"` | Notes with that exact phrase |
| `tag:#project` | Notes with that tag |
| `path:Journal/` | Notes inside the Journal folder |
| `-word` | Notes that do NOT contain "word" |
| `file:README` | Notes with "README" in the filename |

### Starred notes

Right-click any note → **Star** to pin it in the Starred section of the sidebar for quick access.

### Bookmarks

The Bookmarks plugin (built-in, enabled by default) lets you bookmark notes, headings, searches, and even graph views.

---

## The Graph View

Click the **graph icon** in the left sidebar to open the global graph.

- **Dots** = notes
- **Lines** = links between notes
- **Bigger dots** = notes with more connections
- **Clusters** = groups of related topics

### What the graph is good for

- Discovering notes you forgot about
- Seeing which topics are well-connected vs. orphaned
- Getting a bird's-eye view of your knowledge base

### What the graph is NOT good for

- Day-to-day navigation (use Quick Switcher instead)
- Replacing folders or tags for organization

### Filters

Use the graph settings panel to filter by tags, folders, or search terms. Try filtering to `#project` to see only project-related connections.

---

## Daily Notes and Templates

### Daily Notes

A new note for each day — perfect for journaling, meeting logs, or capturing quick thoughts.

**Enable it:**
1. Settings → **Core plugins** → turn on **Daily notes**
2. Settings → **Daily notes** → set the date format (default `YYYY-MM-DD` works well) and folder (e.g., `Journal/`)

**Use it:**
- Click the calendar icon in the sidebar, or
- `Cmd+P` → "Open today's daily note"

Each day gets a fresh note. Link to other notes from your daily entries: `Had a meeting about [[Website Redesign]]`.

### Templates

Reusable note structures you insert with one command.

**Enable it:**
1. Settings → **Core plugins** → turn on **Templates**
2. Create a folder called `Templates`
3. Settings → **Templates** → set the template folder location

**Example template** (`Templates/Meeting Note.md`):

```markdown
# Meeting: {{title}}
**Date:** {{date}}
**Attendees:**

## Agenda

## Notes

## Action Items
- [ ]
```

**Use a template:** `Cmd+P` → "Insert template" → pick one.

---

## Backlinks and the Local Graph

Open any note and look at the **right sidebar** (if hidden, click the arrow on the right edge).

### Backlinks panel

Shows every other note that links *to* the current note. If `[[Git Basics]]` links to your current note, it appears here.

**Unlinked mentions** — Obsidian also finds notes that mention the current note's title in plain text but do not have an explicit link. You can convert these to links with one click.

### Local graph

A mini graph showing only the current note and its direct connections. Useful for exploring the neighborhood of an idea without the visual noise of the full graph.

---

## Settings Worth Changing Early

Open Settings (gear icon, bottom-left):

| Setting | Location | Recommendation |
|---|---|---|
| **Default editing mode** | Editor → Default editing mode | Live Preview |
| **New link format** | Files & Links → Default location for new notes | Same folder as current file, or a specific Inbox folder |
| **Attachment folder** | Files & Links → Default location for attachments | Create an `Attachments/` folder |
| **Always update links** | Files & Links → Automatically update internal links | Keep ON — renames won't break links |
| **Show frontmatter** | Editor → Show front matter | Turn on when you start using metadata |
| **Spellcheck** | Editor → Spellcheck | Turn on |

### Appearance

Settings → **Appearance** — choose light or dark theme. Obsidian has a large community of custom themes if you want to explore later.

---

## Syncing Across Devices

Your vault is a folder of files. Getting it onto your phone, tablet, and other computers is a common need.

### Option 1: iCloud Drive (simplest for Apple users)

Store your vault inside iCloud Drive:

```
~/Library/Mobile Documents/com~apple~CloudDocs/MyVault
```

- **Mac:** Obsidian opens it directly
- **iPhone/iPad:** Obsidian mobile → Open folder as vault → iCloud Drive → MyVault

**Caution:** Do not open the same vault on two devices simultaneously before iCloud finishes syncing — you could get duplicate files. Wait for sync to complete when switching devices.

### Option 2: Obsidian Sync (paid, $4–8/month)

Obsidian's official sync service. Handles conflicts, version history, and end-to-end encryption. Simplest experience if you use multiple platforms (Mac + Windows + Android).

Settings → **Sync** → set up an account.

### Option 3: GitHub (free, for the technically inclined)

Commit and push your vault to a **private** GitHub repo. Pull on other devices. Works well if you already use Git, but Markdown files with frequent edits can create merge conflicts.

### Option 4: Syncthing, Dropbox, OneDrive

Any cloud sync service works since vaults are just folders. Same caution as iCloud about simultaneous editing.

### What NOT to sync

The `.obsidian/` folder contains your settings and plugins. You can sync it (to keep settings consistent across devices) or exclude it (to have different setups per device). Most people sync it.

---

## Plugins (When You Are Ready)

Obsidian has two plugin types:

### Core plugins (built-in, free)

Enable in Settings → **Core plugins**. Good ones to start with:

| Plugin | What it does |
|---|---|
| **Daily notes** | One note per day |
| **Templates** | Reusable note structures |
| **Backlinks** | See who links to the current note |
| **Graph view** | Visual map of your notes |
| **Tag pane** | Browse all tags |
| **Outline** | Table of contents for current note |
| **Word count** | Track note length |
| **Bookmarks** | Pin notes, headings, searches |

### Community plugins (third-party, free)

Enable in Settings → **Community plugins** → turn off Restricted mode → Browse.

Popular community plugins (explore when comfortable with the basics):

| Plugin | What it does |
|---|---|
| **Calendar** | Visual calendar for daily notes |
| **Dataview** | Query your notes like a database |
| **Templater** | Advanced templates with logic |
| **Excalidraw** | Draw diagrams inside notes |
| **Kanban** | Board-style task management |
| **Periodic Notes** | Weekly, monthly, quarterly notes |

**Advice for beginners:** Use the core app for at least a few weeks before adding community plugins. Master links, search, and daily notes first.

---

## Obsidian vs. Other Note Apps

| Feature | Obsidian | Apple Notes | Notion | Evernote |
|---|---|---|---|---|
| **Files on your device** | ✅ Plain text | ❌ Proprietary | ❌ Cloud only | ❌ Cloud only |
| **Works offline** | ✅ Fully | ✅ | ⚠️ Limited | ⚠️ Limited |
| **Linking between notes** | ✅ Core feature | ❌ | ⚠️ Basic | ❌ |
| **Graph visualization** | ✅ | ❌ | ❌ | ❌ |
| **Free** | ✅ Personal use | ✅ | ⚠️ Limits | ⚠️ Limits |
| **Collaboration** | ⚠️ Via Sync/Publish | ✅ | ✅ Excellent | ✅ |
| **Learning curve** | Medium | Low | Medium | Low |
| **Best for** | Personal knowledge, writing | Quick captures | Team wikis, databases | Clipping, storage |

**Choose Obsidian when:** you want a long-term personal knowledge base, you value owning your files, and you think in connections rather than folders.

**Choose something else when:** you need real-time team collaboration (Notion), or you just want simple quick notes (Apple Notes).

---

## A Simple System to Get Started

You do not need a perfect system on day one. Start with this:

### Folder structure

```
MyVault/
├── Inbox/           ← quick captures, process later
├── Journal/         ← daily notes
├── Reference/       ← guides, how-tos, things you look up
├── Projects/        ← active work
└── Templates/       ← note templates
```

### Daily habit (5 minutes)

1. Open today's daily note
2. Write one thing you learned or want to remember
3. Link it to an existing note if relevant: `Learned about [[branching]] today`
4. If nothing exists for that topic, the link creates a new note for later

### Weekly habit (10 minutes)

1. Process your **Inbox** — move notes to the right folder, add links and tags
2. Glance at the **graph view** — any orphaned notes worth connecting?
3. Review open tasks in project notes

### The one rule

**Link generously.** Every time you write something that relates to another note, add a `[[link]]`. Over time, this builds a web that makes everything easier to find and understand.

---

## Common Mistakes and How to Avoid Them

| Mistake | Why it is a problem | Better approach |
|---|---|---|
| Over-organizing before writing | You spend hours on folders instead of thinking | Start with Inbox + Journal; organize later |
| Installing 20 plugins on day one | Overwhelming and unstable | Master core features first |
| Never linking notes | Obsidian becomes a fancy text editor | Link at least one thing per note |
| Putting the vault in a synced folder without understanding conflicts | Duplicate files, lost edits | Read the sync section above; edit on one device at a time |
| Trying to migrate everything at once | Burnout | Move notes in gradually, starting with what you actively use |
| Perfectionism on note titles | Slows you down | Use Quick Switcher — exact titles matter less than you think |

---

## Quick Reference Cheat Sheet

### Keyboard shortcuts (Mac / Windows)

| Action | Mac | Windows |
|---|---|---|
| New note | `Cmd+N` | `Ctrl+N` |
| Quick Switcher (open note) | `Cmd+O` | `Ctrl+O` |
| Command Palette | `Cmd+P` | `Ctrl+P` |
| Search all notes | `Cmd+Shift+F` | `Ctrl+Shift+F` |
| Toggle edit/preview | `Cmd+E` | `Ctrl+E` |
| Insert link | `Cmd+K` | `Ctrl+K` |
| Today's daily note | `Cmd+P` → "daily" | `Ctrl+P` → "daily" |
| Close current pane | `Cmd+W` | `Ctrl+W` |

### Markdown essentials

```markdown
# Heading 1
## Heading 2

**bold**  *italic*

- bullet list
1. numbered list
- [ ] task

[[Link to Note]]
[[Note#Heading|Custom text]]
#tag

> blockquote

`code`
```

### Wikilink syntax

```markdown
[[Note Name]]                          basic link
[[Note Name|Display Text]]             custom display text
[[Note Name#Heading]]                  link to a heading
![[Note Name]]                         embed another note inside this one
![[image.png]]                         embed an image
```

---

## Glossary

| Term | Definition |
|---|---|
| **Vault** | Your entire collection of notes — one folder on disk |
| **Note** | A single Markdown (`.md`) file in your vault |
| **Markdown** | Plain-text formatting syntax using `#`, `*`, `-`, etc. |
| **Wikilink** | Obsidian link format: `[[Note Title]]` |
| **Backlink** | A note that links *to* the note you are viewing |
| **Tag** | A label attached with `#tag-name` |
| **Graph view** | Visual map of notes (dots) and links (lines) |
| **MOC** | Map of Content — a note that indexes related notes |
| **Daily note** | An automatically dated note for each day |
| **Template** | A reusable note structure inserted on demand |
| **Plugin** | An optional feature extension (core or community) |
| **Frontmatter** | Metadata at the top of a note between `---` lines |
| **Command Palette** | Quick-access menu for any Obsidian command |
| **Quick Switcher** | Fast note search and navigation by name |
| **Live Preview** | Editing mode that shows formatted text inline |
| **Embed** | Displaying another note or image inside a note with `![[]]` |

---

*You do not need to use every feature on day one. Create a vault, write a few notes, link them together, and let your system grow naturally.*