Obsidian for Worldbuilding: Setup Guide

Obsidian is one of the best tools available for worldbuilding — and it's completely free. Its local-first, Markdown-based approach combined with a powerful linking system and graph view makes it ideal for managing the complex, interconnected information that worlds require. This guide walks you through setting up Obsidian specifically for worldbuilding, from initial vault creation to essential plugins and templates.
Why Obsidian for Worldbuilding
Before diving into setup, here's why Obsidian stands out among worldbuilding tools:
| Feature | Benefit for Worldbuilding |
|---|---|
| Bidirectional links | Connect any note to any other note — NPCs to locations, events to factions |
| Graph view | Visualize your entire world as an interconnected web |
| Local storage | Your world data stays on your machine, not someone else's server |
| Markdown files | Plain text means your notes are future-proof and portable |
| Community plugins | Hundreds of plugins for maps, timelines, dice rolling, and more |
| Free | No subscription for core features |
Initial Vault Setup
Step 1: Create Your Vault
Open Obsidian and create a new vault. Name it after your world (e.g., "Valenheim" or "My Campaign World"). Choose a location on your local drive — avoid cloud-synced folders initially to prevent sync conflicts.
Step 2: Create Your Folder Structure
Create these top-level folders:
📁 01-World Overview 📁 02-Geography 📁 03-Cultures & Peoples 📁 04-History 📁 05-Magic & Religion 📁 06-Politics & Factions 📁 07-NPCs 📁 08-Items & Artifacts 📁 09-Session Notes 📁 10-Campaign Planning 📁 Templates 📁 Assets (maps, images)
The numbered prefixes keep folders in a logical order. You'll navigate primarily through links, but folders provide a safety net when you want to browse.
Step 3: Create Your Home Note
Create a note called "Home" or "Dashboard" in the root of your vault. This is your entry point. Structure it as a table of contents with links to key index notes:
# [World Name] — Master Index ## Quick Access - [[World Overview]] - [[Active Quests]] - [[Next Session Prep]] - [[NPC Index]] ## Regions - [[Northern Kingdoms]] - [[Southern Empire]] - [[The Underdark]] ## Current Campaign - [[Session Log]] - [[Party Members]] - [[Current Arc: The Dragon War]]
Essential Plugins for Worldbuilding
Dataview (Must-Have)
Dataview lets you query your notes like a database. Add metadata to your notes (called "frontmatter") and Dataview can generate dynamic lists, tables, and summaries.
Example: Add this frontmatter to every NPC note:
--- type: npc location: Thornwall faction: Merchants Guild status: alive ---
Then create a query that lists all living NPCs in Thornwall:
```dataview TABLE location, faction FROM "07-NPCs" WHERE location = "Thornwall" AND status = "alive" SORT file.name ASC ```
Templater (Must-Have)
Templater lets you create note templates with dynamic fields. When you create a new NPC note, Templater auto-fills the date, prompts you for key fields, and formats everything consistently.
Leaflet (Maps)
The Leaflet plugin embeds interactive maps directly in your notes. Upload your world map image and add markers that link to location notes. Click a city on the map, and it opens the city's note.
Timeline (History)
The Timeline plugin generates visual timelines from your notes. Add date metadata to historical events, and the plugin renders them chronologically.
Dice Roller
For TTRPG worldbuilders, the Dice Roller plugin lets you roll dice directly in your notes. Use it for random encounter tables, NPC generation, and loot drops.
Kanban
Use Kanban boards for session planning and campaign management. Columns like "Plot Hooks Available," "Active Quests," "Resolved," and "Abandoned" give you a visual overview of your campaign's state.
Worldbuilding Templates for Obsidian
Create these templates in your Templates folder:
Location Template
---
type: location
region:
population:
government:
tags: []
---
# {{title}}
## Overview
[2-3 sentence description]
## Notable Features
-
## Key NPCs
-
## Economy
-
## History
-
## Secrets
-
## Connected Locations
-
NPC Template
---
type: npc
race:
location:
faction:
status: alive
tags: []
---
# {{title}}
## Appearance
[Brief physical description]
## Personality
[3 key traits]
## Motivation
[What do they want?]
## Secret
[What are they hiding?]
## Relationships
-
## Notes
-
Graph View: Visualizing Your World
Obsidian's graph view shows every note as a node and every link as an edge. For worldbuilders, this is incredibly powerful:
- Clusters reveal communities — Notes that link heavily to each other form visual clusters. These often correspond to regions, factions, or plot lines.
- Orphan notes reveal gaps — A note with no links is disconnected from your world. Either it needs connections or it doesn't belong.
- Color-code by type — Use graph filters to color NPCs, locations, and factions differently. The visual pattern reveals your world's structure at a glance.
Best Practices
- Link aggressively. Every time you mention a person, place, or concept that has (or should have) its own note, make it a link. Even if the note doesn't exist yet — Obsidian will create it when you click.
- Use aliases. If an NPC is known by multiple names, add aliases in the frontmatter so links work regardless of which name you use.
- Keep notes atomic. One note per concept. Don't put three NPCs in one note — make three notes.
- Review your graph weekly. Spend 10 minutes looking at the graph view. Spot disconnected notes, unexpected clusters, and areas that need expansion.
- Back up regularly. Obsidian stores files locally. Use Git, Syncthing, or manual backups to protect your work.
Continue Exploring
This article is part of our Worldbuilding Fundamentals guide, within the Worldbuilding Hub. Explore related articles:
- Ultimate Guide: Worldbuilding
- Fantasy World Name Generator: Complete Guide
- Fantasy World Building: Complete Resource
- 300+ Fantasy World Names by Genre
Need names for your world? Try our Kingdom Name Generator. Populate your world with characters from the NPC Generator, or kickstart adventures with the Quest Hook Generator.
Ready to build your world?
Interactive maps, wikis, and timelines — all in one place.
Coming Soon