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

# What is a note in Spote?

> A Spote note contains a title, markdown body, bucket, auto-extracted tags, and attachments. Learn note structure, access levels, and conflict detection.

A note is the core unit of Spote. Every note has a title, a markdown body, a bucket (the folder it lives in), tags derived from your text, and optional attachments. Notes are searchable by meaning, shareable with other users, and accessible from both the web app and AI agents via MCP.

## Note structure

**Title**

The name of your note. It appears in the note list and is included in search indexing, so a descriptive title helps Spote surface the note later.

**Text**

The body of your note, written in Markdown. The editor supports headings, bold, italic, tables, code blocks, images, and lists. You can switch between a rich WYSIWYM editor and raw Markdown source at any time.

<Note>
  Notes support [Mermaid](https://mermaid.js.org/) diagrams. Add a fenced code block with the `mermaid` language tag to render flowcharts, sequence diagrams, and more directly in your note.
</Note>

**Bucket**

The folder your note lives in. The default bucket is **Inbox**. You can move a note to any bucket — or create a new one — using the bucket selector in the editor.

**Tags**

Hashtags extracted automatically from your note's text. Write `#project` anywhere in the body and "project" appears as a tag — no separate tagging step needed. Tags are stored without the `#` and are always lowercased.

**Attachments**

Images and files you paste or drag into the editor. Attachments are stored securely and linked inline in your note's Markdown.

## Access levels

When a note is shared with other users, each person has one of three access levels:

| Level     | Can do                                    |
| --------- | ----------------------------------------- |
| **Owner** | Read, edit, share, and delete the note    |
| **Write** | Edit the note, but not share or delete it |
| **Read**  | View the note only                        |

## Version conflict detection

If you and someone else edit the same shared note at the same time, Spote detects the conflict when you save. Instead of silently overwriting anyone's work, Spote shows you the current saved version alongside your local changes and lets you decide how to proceed — keep your version, load the current one, or reconcile the differences manually.
