> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vowen.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Obsidian

> Write meeting notes into your Obsidian vault as Markdown, with frontmatter.

<div style={{ marginTop: "-2.5rem" }}>
  <Info>The <a href="https://vowen.ai" className="font-semibold underline-offset-2" style={{ color: "#8b5cf6", backgroundColor: "rgba(139, 92, 246, 0.12)", border: "1px solid rgba(139, 92, 246, 0.35)", padding: "2px 8px", borderRadius: "6px", fontSize: "0.85em", textDecoration: "none", whiteSpace: "nowrap" }}>Pro plan</a> unlocks the Obsidian integration so meeting notes flow into your vault automatically.</Info>
</div>

## Overview

Vowen writes each finished meeting note into your Obsidian vault as plain Markdown files with YAML
frontmatter. Nothing is appended to a daily note, and no plugin is required. Vowen writes files
directly into the vault folder on disk, and Obsidian picks them up.

## Setup

<Steps>
  <Step title="Open the integration">
    Go to **Settings > Meeting Notes > Integrations** and click **Configure Obsidian**.
  </Step>

  <Step title="Pick your vault">
    Set the **Vault Path** to the directory your Obsidian vault lives in. **Browse** opens a folder
    picker.
  </Step>

  <Step title="Choose a parent folder">
    **Folder** is the folder inside the vault that Vowen writes into. It defaults to `Vowen`. A live
    hint shows where notes will land, for example `MyVault/Vowen/`.
  </Step>

  <Step title="Choose what to save">
    Under **What to save**, enable the **Summary**, the **Transcript**, or both. Both are on by
    default, and at least one must stay enabled. Turning the last one off switches the other back on.
  </Step>

  <Step title="Optionally keep notes synced">
    Turn on **Keep notes synced** if you want later edits to reach the vault. See
    [Keeping the vault up to date](#keeping-the-vault-up-to-date).
  </Step>

  <Step title="Save">
    Click **Save**. **Disconnect** clears the vault path and resets every option.
  </Step>
</Steps>

<Frame caption="Obsidian is configured on the Integrations tab of Notes settings. The gear opens its vault and folder settings.">
  <img src="https://mintcdn.com/vowen/94qaixcfbwWHsixE/images/app/notes-settings-integrations.png?fit=max&auto=format&n=94qaixcfbwWHsixE&q=85&s=43ee37207c0c0a6ac732da222b5e764f" alt="The Integrations tab of Notes settings showing a connected Obsidian card naming its vault, a Webhook card, and an Export all notes row" width="2400" height="1600" data-path="images/app/notes-settings-integrations.png" />
</Frame>

## How it works

When a meeting note finishes, Vowen creates a **dedicated folder for that note** inside your chosen
parent folder and writes the content as Markdown files:

<Frame caption="The Obsidian panel: which vault, which folder, what to save, and whether later edits keep syncing.">
  <img src="https://mintcdn.com/vowen/neO8QYHih6ewC77b/images/app/obsidian-config.png?fit=max&auto=format&n=neO8QYHih6ewC77b&q=85&s=a5246d5fa79d4b672829911b9cc9e569" alt="The Configure Obsidian panel with Vault Path, Folder, a What to save group with Summary and Transcript toggles, and Keep notes synced" width="2400" height="1600" data-path="images/app/obsidian-config.png" />
</Frame>

```
<vault>/<Folder>/YYYY-MM-DD <Note title>/
├── summary.md
└── transcript.md
```

### Folder names

The folder name is the note's **local date**, a space, then the note title:

```
2026-08-24 Weekly sync with Design
```

<Warning>
  The date prefix is part of the folder name. Any Dataview, Templater, or QuickAdd recipe that matches
  on the note title alone will not find these folders.
</Warning>

* The date comes from the note's own timestamp and is formatted in **local time**, deliberately, so
  an evening meeting in a negative-UTC zone does not roll forward to the next day
* Characters that are illegal in a path (`/ \ ? % * : | " < >`) are replaced with `-`
* If the folder name is already taken, Vowen creates `... (1)`, `... (2)`, and so on

### Files

`summary.md` holds the summary; `transcript.md` holds the full transcript with any speaker names you
assigned. A file is written when that content exists **and** you kept it enabled under
**What to save**.

<Note>
  There is one override. If the side you chose is empty, Vowen writes the other side instead, so the
  sync is never a silent no-op. Pick summary only, and a note that has a transcript but no summary
  still gets its transcript written. A note with neither a summary nor a transcript is skipped
  entirely.
</Note>

### Frontmatter

Every file starts with YAML frontmatter:

```yaml theme={null}
---
title: "Weekly sync with Design"
date: 2026-08-24T18:30:00.000Z
source: vowen
type: summary
template: Meeting Notes
---
```

| Field | Notes |
| - | - |
| `title` | The note title, quoted |
| `date` | A **full ISO-8601 timestamp in UTC**, not the local date used by the folder name. The two can differ by a day near midnight |
| `source` | Always `vowen` |
| `type` | `summary` or `transcript` |
| `template` | The name of the [summary template](/meeting-notes/summaries#custom-templates) that produced the note. Omitted when there is none |

<Tip>
  Because `date` is a real timestamp, sort and filter on the frontmatter field rather than parsing the
  folder name. Use the folder name for a chronological view in the file tree, where the `YYYY-MM-DD`
  prefix does the sorting for you.
</Tip>

Vowen strips its internal citation markers out of the summary before writing, so vault copies never
contain them.

## Keeping the vault up to date

Vowen writes a note to the vault once, when the note finishes. Edits you make afterwards do **not**
reach the vault unless you take one of the two routes below.

### Keep notes synced (automatic)

Turn on **Keep notes synced** in the Configure Obsidian screen. It is off by default. Once on, Vowen
re-writes the vault copy whenever you edit a note's:

* summary
* transcript
* title
* **speaker names**

Edits are debounced, so the summary editor firing once per keystroke results in a single write about
two and a half seconds after you stop typing. The re-sync overwrites the same folder rather than
creating a duplicate.

<Warning>
  **Renaming speakers does not reach your vault** unless **Keep notes synced** is on, or you sync that
  note manually. The in-app transcript updates immediately; the vault copy still says `Speaker 1`.
</Warning>

Changing a note's **tags** does not trigger a re-sync, because tags are not written to the vault.

### Sync with Obsidian (manual)

Open any meeting note and click **Sync with Obsidian**. Vowen writes the note's current state to the
vault right away and confirms with a toast. Useful after editing a summary, renaming a note or its
speakers, or changing the **What to save** options.

Manual sync does one thing automatic sync does not. If Vowen has no record of a folder for this
note, manual sync **adopts an existing folder** that already matches the canonical `YYYY-MM-DD Title`
name instead of creating a numbered duplicate, which is what lets notes exported before Vowen
started tracking folder paths get updated in place. Automatic sync at note creation deliberately
does not do this, so two genuinely different meetings with the same name on the same day stay in
separate numbered folders.

## Driving Obsidian workflows

Because the frontmatter carries `source`, `type`, and `template`, and the transcript ships as its own
file, you can key Templater, QuickAdd, or Dataview flows off any of those values.

A Dataview query over the summaries, for example:

```
TABLE date, template
FROM "Vowen"
WHERE source = "vowen" AND type = "summary"
SORT date DESC
```

`type` distinguishes the two files inside each folder, so filter on it unless you want each note
counted twice.

## Use cases

* **Meeting archive**: every call lands in the vault as searchable Markdown with a date-sorted folder
* **Template routing**: post-process notes by `template` name with Templater or QuickAdd
* **Research notes**: dictate observations into notes and have them indexed by Dataview
* **Handoff**: share the vault folder rather than exporting a note one at a time


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.