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

# Local Files

> Import markdown files and Obsidian vaults into your library

# Local Files

Import markdown files, text files, or entire Obsidian vaults directly from your computer. Resona processes them locally and adds them to your library with full AI insights.

## How to Import

<Steps>
  <Step title="Open the Add modal">
    Click the **+** button in your library
  </Step>

  <Step title="Choose your files">
    Select individual files or an entire folder from your computer
  </Step>

  <Step title="AI processes your content">
    Resona generates summaries, key points, and tags for each file (10-30 seconds per file)
  </Step>
</Steps>

## Supported Formats

| Format   | Extension |
| -------- | --------- |
| Markdown | `.md`     |
| Text     | `.txt`    |

## Obsidian Vaults

Resona automatically detects Obsidian vaults when you select a folder. When a vault is detected:

* All markdown notes are imported recursively, including subfolders
* Obsidian-specific files (`.obsidian/` config folder, templates) are skipped automatically
* Your vault structure is preserved — each note becomes an article in your library
* Frontmatter metadata is respected

<Info>
  Your vault stays on your machine. Resona reads the files locally and only sends the content for AI processing. No sync, no plugins, no changes to your vault.
</Info>

## Importing a Folder

When you select a folder, Resona scans it recursively for supported files. This works for any folder structure, not just Obsidian vaults.

<Warning>
  Large folders (500+ files) may take several minutes to process. You can continue using Resona while processing happens in the background.
</Warning>

## Tips

<AccordionGroup>
  <Accordion title="Re-import to update">
    Resona does not auto-sync with your local files. To pick up new or edited notes, simply import the folder again. Duplicates are detected and skipped.
  </Accordion>

  <Accordion title="Works great with any markdown workflow">
    Whether you use Obsidian, Logseq, Bear exports, or plain markdown files — if it's `.md`, Resona can import it.
  </Accordion>
</AccordionGroup>