# Obsidian

Marked works with Obsidian notes in two ways: open a vault folder for automatic following, or use the community plugin for tighter sync.

Obsidian’s built-in preview is ideal when you never leave the app. Choose Marked when you want publish-quality export, advanced proofreading, custom CSS themes, or the same live preview workflow across multiple editors. See Marked vs Obsidian Preview for a full comparison.

Contents

- Open an entire vault
- Obsidian callout syntax
- Marked 3 Obsidian plugin

## Open an entire vault

Drag the vault folder (the directory that contains Obsidian’s hidden configuration folder at the vault root) onto Marked in the Dock. Marked watches that tree, keeps the most recently edited note in the preview, and updates as you save in Obsidian.

For vault-specific defaults (style, processor, base URL for images, and so on), add a Custom Rule that matches paths under that vault.

## Obsidian callout syntax

When the MultiMarkdown processor runs, Marked converts common Obsidian-style callouts (the `> [!note]` pattern) into styled block markup so they match the rest of your preview.

## Marked 3 Obsidian plugin

The Marked 3 Obsidian plugin can open the current note or the whole vault with commands or hotkeys so the Marked window tracks what you are editing. Use the Command Palette (⌘P) and search for Marked, or assign hotkeys in Obsidian’s Hotkeys settings.

### Installing from Community Plugins

In Obsidian, open Settings → Community plugins, browse or search for marked, and install Open in Marked.

### Manually installing the plugin

If you prefer to install from GitHub:

1. Download `main.js` and `manifest.json` from the latest release on GitHub (or build them from the Marked3-obsidian repository).
2. In your vault, create the plugin folder under `plugins/` inside Obsidian’s configuration directory at the vault root. The folder name must match the plugin `id` in `manifest.json` (see the plugin README for the full path).
3. Copy `main.js` and `manifest.json` into that folder.
4. In Obsidian, open Settings → Community plugins, turn off Restricted mode if needed, and enable Open in Marked.

#### Next up: OmniOutliner and OPML ▶

Support Site | Legal | Privacy