obsidian worldbuilding

Obsidian for Worldbuilding: Setup Guide

Anima Team · 4 min read · April 1, 2026
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:

FeatureBenefit for Worldbuilding
Bidirectional linksConnect any note to any other note — NPCs to locations, events to factions
Graph viewVisualize your entire world as an interconnected web
Local storageYour world data stays on your machine, not someone else's server
Markdown filesPlain text means your notes are future-proof and portable
Community pluginsHundreds of plugins for maps, timelines, dice rolling, and more
FreeNo 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

  1. 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.
  2. Use aliases. If an NPC is known by multiple names, add aliases in the frontmatter so links work regardless of which name you use.
  3. Keep notes atomic. One note per concept. Don't put three NPCs in one note — make three notes.
  4. Review your graph weekly. Spend 10 minutes looking at the graph view. Spot disconnected notes, unexpected clusters, and areas that need expansion.
  5. 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:

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