# Obsidian plugin

> Publish Obsidian notes to your Blogizi blog — frontmatter, drafts, and updates by slug.

HTML version: https://blogizi.com/docs/obsidian
Markdown version: https://blogizi.com/docs/obsidian.md

Write posts in Obsidian and push them to Blogizi without leaving your vault. The plugin uses the same account API key as the CLI.

> **Community plugin:** Install from [community.obsidian.md/plugins/blogizi](https://community.obsidian.md/plugins/blogizi) (Add to Obsidian), or search for **Blogizi** under Settings → Community plugins. Source: [blogizi-obsidian](https://github.com/bytemindlab/blogizi-obsidian).

## Install

1. Open [Blogizi on Obsidian Community Plugins](https://community.obsidian.md/plugins/blogizi) and click **Add to Obsidian** — or in Obsidian go to Settings → Community plugins → Browse and search for **Blogizi**
2. Enable **Blogizi** under Community plugins → Installed plugins
3. For local development, clone [bytemindlab/blogizi-obsidian](https://github.com/bytemindlab/blogizi-obsidian), run `npm install && npm run build`, and symlink into `YourVault/.obsidian/plugins/blogizi/`

## Configure

1. Open Settings → **Blogizi**
2. Paste your **account API key** from Dashboard → **Account → API** on blogizi.com
3. Leave API URL as `https://blogizi.com` unless you're pointing at a local/dev server
4. Click **Load projects** and pick a blog (optional if you only have one project)
5. Optionally set the posts folder (default `Blogizi`), auto-insert frontmatter, and update-by-slug

## Commands & ribbon

Use the command palette (`Cmd/Ctrl + P`) or the left ribbon:

- **Blogizi: New blog post** (ribbon: file-plus) — creates a note in your posts folder with YAML frontmatter
- **Blogizi: Insert frontmatter** — adds the template to the open note
- **Blogizi: Upload as draft** (ribbon: upload) — pushes the open note as a draft
- **Blogizi: Publish** — pushes the open note as published

## Typical workflow

1. Create a new post (command or ribbon)
2. Fill `title`, `description`, `keyword`, and confirm `slug`
3. Write the markdown body
4. Upload as draft or Publish — a notice shows the public URL

With **Update existing posts by slug** enabled (default), re-pushing the same `slug` updates that post instead of failing.

## Frontmatter

Same format as [Write in Markdown](/docs/markdown-frontmatter):

```yaml
---
title: "How we built our auth flow"
description: "A short meta description"
keyword: "indie app authentication"
slug: how-we-built-our-auth-flow
status: "draft"
date: "2026-08-07"
readingTime: 0
wordCount: 0
---

Your markdown content here.
```

> Prefer the terminal? Use the [Blogizi CLI](/docs/cli-publishing) with the same account key — drafts and publishes are interchangeable with the plugin.