obsidian-writer

# Obsidian Writer

Write .md and .canvas files that render correctly in Obsidian. Output to the vault directory, synced via Git.

## Vault Location

Default: `~/obsidian-vault/` (configurable per request).

## Workflow

1. Write `.md` / `.canvas` files following specs below
2. Git commit + push (agent does this automatically)
3. User's Mac Mini pulls → syncs to iCloud → Obsidian reads

## Markdown — Obsidian-Specific Syntax

Standard Markdown (headings, bold, lists, code blocks) is assumed known. Only Obsidian extensions below:

### Properties (Frontmatter)

Must be the **very first thing** in the file:

```yaml
---
tags:
  - finance/macro
  - iran-war
aliases:
  - 伊朗战争概览
cssclasses:
  - wide-page
created: 2026-03-10
---
```

Reserved keys: `tags`, `aliases`, `cssclasses`, `publish`, `permalink`, `description`.

### Internal Links (Wikilinks)

```markdown
[[Note Name]]                    # link to note
[[Note Name|Display Text]]      # custom display
[[Note Name#Heading]]            # link to heading
[[Note Name#^block-id]]          # link to block
```

### Block References

Add `^block-id` at end of any paragraph/list item:

```markdown
This is an important paragraph. ^key-insight

- List item ^item-ref
```

Then link: `[[Note Name#^key-insight]]`

Block IDs: lowercase alphanumeric + dashes only.

### Embeds

```markdown
![[Note Name]]                   # embed entire note
![[Note Name#Heading]]           # embed section
![[image.png]]                   # embed image
![[image.png|300]]               # resize width 300px
![[image.png|300x200]]           # exact dimensions
![[audio.mp3]]                   # embed audio player
![[video.mp4]]                   # embed video player
![[document.pdf]]                # embed PDF
![[document.pdf#page=3]]         # embed specific page
```

Supported formats — see `references/file-formats.md`.

### Callouts

```markdown
> [!note] Optional Title
> Content with **Markdown** and [[wikilinks]].

> [!tip]- Foldable (collapse...