obsidianmd/obsidian-maps

Map layout for Obsidian Bases. Display your notes as an interactive map view.

TypeScript

532

98 commits

updated Aug 3, 2026

See the code

README

Adds a map layout to Obsidian Bases so you can display notes as an interactive map view.

Map view for Obsidian Bases

  • Dynamically display markers that match your filters.
  • Use marker icons and colors defined by properties.
  • Load custom background tiles.
  • Define default zoom options.

Installation

  1. Open Settings → Community plugins.
  2. Select Browse, then search for Maps.
  3. Select Install, then Enable.

Usage

Add a coordinates property to each note you want to appear on the map. Both a text property and a list property work:

location: 34.13956, -118.38710
location:
  - 34.13956
  - -118.38710

Then open a base, add a view, and set its type to Map. In the view options, set Marker coordinates to your property. Markers appear for every note matching the view's filters, and update as those filters change.

The remaining view options let you set the center coordinates, default zoom, and zoom limits, and choose properties to drive each marker's icon and color.

Backgrounds

Maps use OpenFreeMap tiles by default. To use different tiles, go to Settings → Maps and add a background with a tile URL or style URL. You can set a separate URL for dark mode.

See the full documentation on the Obsidian Help site for examples, tips, and troubleshooting.

maps
obsidian
obsidian-plugin

obsidianmd/obsidian-maps

Map layout for Obsidian Bases. Display your notes as an interactive map view.

TypeScript

532

98 commits

updated Aug 3, 2026

See the code

README

Adds a map layout to Obsidian Bases so you can display notes as an interactive map view.

Map view for Obsidian Bases

  • Dynamically display markers that match your filters.
  • Use marker icons and colors defined by properties.
  • Load custom background tiles.
  • Define default zoom options.

Installation

  1. Open Settings → Community plugins.
  2. Select Browse, then search for Maps.
  3. Select Install, then Enable.

Usage

Add a coordinates property to each note you want to appear on the map. Both a text property and a list property work:

location: 34.13956, -118.38710
location:
  - 34.13956
  - -118.38710

Then open a base, add a view, and set its type to Map. In the view options, set Marker coordinates to your property. Markers appear for every note matching the view's filters, and update as those filters change.

The remaining view options let you set the center coordinates, default zoom, and zoom limits, and choose properties to drive each marker's icon and color.

Backgrounds

Maps use OpenFreeMap tiles by default. To use different tiles, go to Settings → Maps and add a background with a tile URL or style URL. You can set a separate URL for dark mode.

See the full documentation on the Obsidian Help site for examples, tips, and troubleshooting.

maps
obsidian
obsidian-plugin

Significant stargazers

leah

446 followers · starred Mar 2026

Don McCurdy

2,494 followers · starred Nov 2025

Sven Greb

278 followers · starred Nov 2025

aaronraimist

137 followers · starred Oct 2025