Sources
Obsidian - ONA.UNO Docs
Your Obsidian vaults become part of your unified knowledge timeline.

What It Does
The Obsidian source indexes all Markdown files in a vault. Your notes are summarized, tagged, and made searchable alongside everything else in ONA.UNO. Changes sync automatically — edit a note in Obsidian, and ONA.UNO updates within seconds.
Sources are configured per Set. If you use multiple Sets, add each vault to the Set you want it to belong to. See Sets (Libraries).
Key Features
Clean Text Extraction
ONA.UNO reads your Markdown files and extracts clean text for AI processing. YAML frontmatter is parsed separately — your tags and aliases are preserved and used, but the raw YAML block doesn’t clutter summaries or search results.
Frontmatter Support
If your notes have frontmatter, ONA.UNO uses it:
- Title from
title:field (falls back to first heading or filename) - Tags from
tags:field (merged with AI-suggested tags) - Aliases are recognized for search
Real-Time Sync
ONA.UNO watches your vault for changes. Create a new note, edit an existing one, or reorganize your folder structure — updates appear in your timeline automatically.
Deep Links
Click any Obsidian item in ONA.UNO to open the original note. The link uses obsidian:// URLs, so it works even if your vault has moved.
Companion Plugin
ONA.UNO includes an optional Obsidian plugin that enables bidirectional linking.
What It Does
- Open in ONA.UNO — jump from a note in Obsidian directly to its ONA.UNO entry
- Chat in ONA.UNO — start a new chat conversation about the current note
- Status indicator — shows whether the current vault is connected to ONA.UNO
Installation
- Copy the plugin folder to your vault’s
.obsidian/plugins/directory - Enable ONA.UNO Companion in Obsidian’s Community Plugins settings
- The plugin appears in your left sidebar
The plugin reads ONA.UNO’s local database to match notes. No network access is required.
Setup
- Go to Settings → Sources
- Click Add Source and choose Obsidian
- Select your vault folder
- ONA.UNO begins indexing
Tips
- You can add multiple vaults as separate sources
- Only
.mdfiles are indexed (other file types in the vault are ignored) - Hidden files and folders (starting with
.) are skipped - Large vaults with thousands of notes may take a few minutes on first scan