Geode
Your notes. Plain Markdown. Fully yours.

A place for ideas
to stay connected.

Geode is an open-source, local-first Markdown knowledge base. Open any folder as a vault, write in plain files, and follow the links between what you know.

Open source · MIT · v0.13.0 · iOS managed-vault MVP validated

Field Notes / Geode
Garden plan.mdLive Preview
Projects / Garden plan

A garden that teaches itself.

Build the first beds around what the soil already knows. Start with the observations in [[Soil notes]].

Keep each season’s decisions close to the evidence that shaped them.

Next steps

  • Map the sun across the south bed
  • Review [[Planting log]]
  • Tag open questions for spring
Saved as plain Markdown
Write, link, and navigate without leaving your files.Illustrative workspace · simplified for clarity
▤ Plain Markdown files↗ First-class linked notes⌕ Search across your vault
From a folder to a knowledge base

Less managing a system.
More following your thinking.

Geode keeps the core loop close to the files you already own: open a folder, write naturally, and move through the connections.

01

Open any folder.

Your vault stays a normal folder of Markdown notes and attachments on disk.

Field notes
⌄ Projects
▤ Garden plan.md
▤ Soil notes.md
02

Write in Markdown.

Live Preview keeps syntax close while headings, links, tasks, and callouts stay readable.

Garden plan.md
# What the soil knows

Start with [[Soil notes]]

Saved ✓
03

Follow every connection.

Wikilinks, backlinks, tags, and search keep related ideas within reach.

The local-first foundation

Everything you need for a connected vault.

The core loop works today: vaults, editing, wikilinks, backlinks, search, tags, and reading view.

Your vault, on your disk

Plain files.
Lasting ownership.

Open any folder. Edit anywhere. Geode notices external changes without an import step.

01

Vaults

Open any folder as a vault. External edits are picked up live, no import step required.

02

Editor

CodeMirror 6 with markdown highlighting, [[wikilink]] autocomplete, Cmd/Ctrl+click to follow, autosave, and rename-updates-links.

03

Reading view

Callouts (13 types, foldable), embeds for notes/images/audio/video, highlights, tags, tables, task lists, and YAML properties.

04

Connected notes

Backlinks pane, outline, tag pane, unresolved-link styling, and link resolution by shortest path and alias.

05

Search

tag:, path:, and file: operators, quoted phrases, negation, and regex — right in the search bar.

06

Workspace

Tabs, split panes, pinned tabs, collapsible sidebars, and a status-bar word count.

07

Command palette & quick switcher

Cmd+P for commands, Cmd+O to jump between notes, Cmd+D for daily notes.

08

Themes

Dark and light themes driven by CSS variables, matching the same theming model as the original.

Install Geode

Your vault is a download away.

Prebuilt macOS installers for Apple Silicon and Intel are published whenever a version tag is pushed.

View the latest release
Platform
macOS
Builds
Apple Silicon · Intel
Not available
Windows · Linux
Install on macOS
  1. 1
    Download the dmg

    Grab Geode-<version>-arm64.dmg (Apple Silicon) or Geode-<version>.dmg (Intel) from the latest GitHub release.

  2. 2
    Drag Geode to Applications

    Open the dmg and drag Geode.app into your Applications folder.

  3. 3
    Launch it

    Every release is Developer ID signed, notarized, and stapled by Apple before it ships, so Geode opens normally the first time — no security prompt to click through.

iOS status The managed-vault MVP has passed native and UI automation plus physical-device validation for vault discovery and opening notes. It is not yet a public iOS release: Files/File Provider-backed vaults, community plugins, and release signing and distribution remain open production gates.

See what's next for Geode

Follow the public roadmap, or tell us what you'd like Geode to do.