the Obsidian Protocol

Your field guide to Standard Garden.

Contents

::obsidian

the recommended way to publish to Standard Garden is through Obsidian, the markdown note-taking app.

Setup

  1. Install the Standard Garden plugin from Obsidian Community Plugins
  2. Open Settings Standard Garden
  3. Enter your API key (get it from ::account in the Command Palette)
  4. Set your garden name (e.g., your-name)

Publishing

Add frontmatter to any note you want to publish:

---
published: true
pinned: false
private: false
---

# Your Note Title

Your content here...

the plugin will automatically sync your notes to Standard Garden.

Frontmatter Options

  • published: true – Make note visible on your garden
  • pinned: true – Pin to top of your garden
  • private: true – Hide from public feed (Estate only)
  • theme: dark – Override default theme

Learn more: See the complete Frontmatter Schema Reference for all available fields, themes, and advanced options.

::email

the simplest way to publish is via email. Perfect for quick thoughts or when you’re away from your computer.

Your Email Address

Every garden has a unique email address:

[email protected]

How it Works

  1. Send an email to your garden address
  2. Subject line becomes the note title
  3. Email body becomes the content
  4. Note is published immediately

Advanced Options

Add tags in the subject line:

Subject: My Note Title #recipe #cooking

Pin a note by adding [pin]:

Subject: [pin] Important Announcement

::syntax

Standard Garden supports extended Markdown syntax for rich content.

Basic Markdown

# Heading 1
## Heading 2
### Heading 3

**Bold text**
*Italic text*

- List item
- Another item

1. Numbered list
2. Second item

[Link text](https://example.com)

Extended Syntax

Quotes

::quote
This is a beautiful quote.
— Author Name
::

Galleries

::gallery
![Image 1](/path/to/image1.jpg)
![Image 2](/path/to/image2.jpg)
::

Code Blocks

function hello() {
  console.log('Hello, Standard Garden!');
}

Callouts

> [!NOTE]
> This is a note callout

> [!WARNING]
> This is a warning

::api

for advanced users, Standard Garden provides a REST API for programmatic access.

Authentication

Get your API key from the Command Palette (Cmd+K ::account ::key).

Include it in the Authorization header:

Authorization: Bearer your-api-key-here

Endpoints

Create Note

POST /notes/create
Content-Type: application/json

{
  "title": "My Note",
  "content": "# Hello\n\nThis is my note.",
  "published": true,
  "pinned": false
}

List Notes

GET /notes/list

Delete Note

DELETE /notes/:id

Full API documentation: docs.standard.garden/api