Digital garden using Github and Vercel

This site works by connecting your Obsidian notes to a publishing system called a digital garden. When you write notes in Obsidian, they stay private unless you explicitly mark them for publishing using a special setting (dg-publish: true). Once published, those selected notes are sent to GitHub, which acts as a storage space for your site’s content. From there, Vercel automatically detects changes in the GitHub repository and rebuilds your website so it stays up to date. The result is a live website that displays your chosen notes in a connected, wiki-like format, with features like backlinks, search, and graph views, while everything else in your Obsidian vault remains private and under your control.

Tutorial

Phase 1: The "Engine" (GitHub & Vercel)

We need a place for your notes to live online. We'll use a template that does all the coding for you.

  1. GitHub: Go to GitHub and click "Use this template" > "Create a new repository."
  1. Vercel (The Host): Go to Vercel and sign up with your GitHub account.

Phase 2: The "Bridge" (Obsidian Setup)

Now we tell Obsidian how to talk to GitHub.

  1. Install the Plugin: In Obsidian, go to Settings > Community Plugins > Browse. Search for "Digital Garden" and install/enable it.
  2. Create a GitHub Token:
  1. Configure Plugin: In Obsidian, go to the Digital Garden plugin settings:

Phase 3: Tending the Garden (Publishing)

Your garden is ready. Now you just need to pick which notes to "plant."

1. Mark a note for publishing

The plugin only publishes notes that have specific "frontmatter" (data at the very top). At the top of your note, type this exactly:

Markdown


dg-publish: true


2. Set your Homepage

One note needs to be your "Home." Add this to that specific note:

Markdown


dg-publish: true

dg-home: true


3. Hit the Publish Button


Pro-Tips for your Experiment

Last Updated: 29/05/26