> ## 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.

# Write and edit notes in Spote

> Use Spote's WYSIWYM markdown editor to write rich notes with headings, code blocks, images, tables, and Mermaid diagrams. Covers tags, buckets, and saving.

The Spote editor is a WYSIWYM (What You See Is What You Mean) markdown editor — you can write in plain markdown or use the toolbar to format text visually. Both modes stay in sync, so you can switch between them at any time without losing your work.

## Creating a note

Click the **New note** button in the top bar to open a blank editor. Type a title in the title field at the top, then write your content in the body below. The body accepts full markdown syntax.

## Supported formatting

The editor supports the following markdown elements:

<AccordionGroup>
  <Accordion title="Headings">
    Use `#` for H1, `##` for H2, and `###` for H3.

    ```markdown theme={null}
    # Heading 1
    ## Heading 2
    ### Heading 3
    ```
  </Accordion>

  <Accordion title="Bold and italic">
    Wrap text with `**` for bold and `*` for italic.

    ```markdown theme={null}
    **bold text**
    *italic text*
    ```
  </Accordion>

  <Accordion title="Tables">
    ```markdown theme={null}
    | Column A | Column B |
    | -------- | -------- |
    | Value 1  | Value 2  |
    ```
  </Accordion>

  <Accordion title="Code blocks">
    Fenced code blocks with a language tag get syntax highlighting.

    ````markdown theme={null}
    ```python
    def hello():
        print("Hello, world!")
    ```
    ````
  </Accordion>

  <Accordion title="Lists">
    Use `-` or `*` for unordered lists. Use `1.`, `2.`, etc. for ordered lists.

    ```markdown theme={null}
    - Item one
    - Item two

    1. First step
    2. Second step
    ```
  </Accordion>

  <Accordion title="Images">
    Paste an image from your clipboard, drag and drop a file, or use standard markdown image syntax:

    ```markdown theme={null}
    ![Alt text](https://example.com/image.png)
    ```
  </Accordion>

  <Accordion title="Mermaid diagrams">
    Write a fenced code block with the language set to `mermaid` to render a diagram inline.

    ````markdown theme={null}
    ```mermaid
    graph TD
        A[Start] --> B[End]
    ```
    ````
  </Accordion>
</AccordionGroup>

## Tagging

Write `#tagname` anywhere in the note body to tag the note. Tags are extracted automatically as you type and appear as chips below the editor in real time. You don't need to add tags in a separate field — just include them naturally in your text.

```markdown theme={null}
This is a note about my #saas idea and #pricing strategy.
```

## Buckets

Buckets are folders for organizing your notes. Use the bucket selector dropdown in the toolbar to choose an existing bucket or create a new one inline. If you don't select a bucket, the note is saved to **Inbox** by default.

## Attachments

Paste an image directly from your clipboard or drag a file into the editor body. Spote uploads the file automatically and inserts it as standard markdown image syntax at the cursor position:

```markdown theme={null}
![filename.png](/api/files/your-user-id/uuid.png)
```

You can also use the markdown `![]()` syntax directly if you have a URL.

## Raw mode

Click the **WYSIWYG / Markdown** toggle button in the toolbar to switch between the visual editor and raw source mode. In raw mode you edit the underlying markdown text directly — useful for pasting content, bulk editing, or working with complex syntax the visual editor doesn't expose.

## Saving

Click **Save** in the toolbar to store your note. The button is active only when you have unsaved changes.

If someone else has edited the same shared note while you were working on it, Spote detects the conflict when you save and shows a warning. You can choose to **Load current version** (discard your changes and load what's in the database) or **Keep my changes** (dismiss the warning and save again to overwrite).

<Tip>
  Add rich context with tags and a specific bucket — Spote's semantic search works better the more descriptive your notes are.
</Tip>