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

# Notes

> Capture and organize longer content

## Overview

Notes in Qwox are perfect for longer-form content like meeting notes, journal entries, project documentation, and more. The note-taking experience differs between platforms, with the web app offering advanced rich text editing and the mobile app providing a streamlined text-based interface.

## Creating Notes

### From Chat

**Save Message as Note** (Mobile Only):

1. Long-press any chat message
2. Select "Save as Note"
3. The message content becomes a new note

**Quick Note from Chat**:

1. Tap the **+** button in chat
2. Select "Add Note"
3. Enter title, content, and tags
4. Save

**Ask AI to Create Notes**:
You can ask Qwox to create notes for you:

```text theme={null}
"Create a note about my marketing strategy"
"Make a note with my workout routine"
"Save this as a note: [your content]"
```

The AI will create the note using your exact content and optional tags.

### From Library

1. Navigate to Library
2. Tap "New Note" or **+** button
3. Start writing

## Platform Differences

### Mobile App

* **Simple Text Editor**: Plain text input with title, content, and tags
* **Word Counter**: Real-time word count with plan-based limits
* **Quick Creation**: Optimized for fast note capture

### Web App

* **Rich Text Editor**: Full WYSIWYG editor with formatting toolbar
* **Advanced Features**: Tables, code blocks, images, file attachments
* **Collections**: Organize notes into projects, people, locations
* **Resizable Window**: Drag to adjust editor size
* **Keyboard Shortcuts**: Cmd+S (save), Cmd+B (bold), Cmd+I (italic), Esc (close)

## Web Editor Features

The web app uses **Tiptap**, a powerful rich text editor with the following capabilities:

### Text Formatting

* **Bold** (Cmd+B)
* **Italic** (Cmd+I)
* **Headings**: H1, H2, H3
* **Links**: Insert clickable URLs

### Lists & Structure

* **Bullet Lists**: Unordered lists
* **Numbered Lists**: Ordered lists
* **Task Lists**: Interactive checkboxes for to-do items
* **Blockquotes**: Quote formatting
* **Horizontal Rules**: Visual dividers

### Advanced Content

* **Tables**: Insert and edit tables with dynamic row/column controls
* **Code Blocks**: Syntax-highlighted code snippets
* **Images**: Upload and embed images directly
* **File Attachments**: Attach PDFs, documents, audio files (displayed as styled badges)

### Productivity Tools

* **Slash Commands**: Type `/` to access formatting menu with keyboard navigation
  * Navigate with arrow keys
  * Press Enter to select
  * Esc to cancel
* **Insert Date**: Quick button to insert current date (YYYY-MM-DD format)
* **File Type Icons**: Smart icons for attachments (📄 PDF, 📝 DOC, 📊 XLS, 🎵 Audio)
* **Nested Task Lists**: Create multi-level checkboxes
* **Syntax Highlighting**: Code blocks with language-specific colors
* **Unsaved Changes Warning**: Prevents accidental data loss

## Organizing Notes

### Tags

Add tags to categorize and filter notes:

* **Mobile**: Comma-separated tags in the Tags field
* **Web**: Multi-select tag input with visual chips

### Collections (Web Only)

Group notes by projects, people, locations, or organizations:

1. Open a note in the web editor
2. Click "Add to Collection"
3. Select from existing collections or create new ones
4. Notes can belong to multiple collections

Collections are automatically extracted from note content and displayed as cards in the Library.

### Search

Find notes instantly using the Library search bar:

* Search by **title**, **content**, or **tags**
* Filter by **type** (Notes, Images, Files)
* Filter by **collection** (web)
* Filter by **tag**

## Word Limits

Notes have word count restrictions based on your plan:

<Info>
  **Free Plan**: 1,000 words per note

  **Premium Plan**: Unlimited words
</Info>

The editor displays a real-time word counter:

* **Green**: Under 90% of limit
* **Yellow**: 90-100% of limit
* **Red**: Over limit (save disabled)

## Working with Notes

### Editing

* **Mobile**: Tap a note in Library → Edit content → Save
* **Web**: Click a note in Library → Full editor opens → Make changes → Cmd+S or Save button

**AI-Assisted Editing**:
Ask Qwox to modify your notes:

```text theme={null}
"Update my marketing note with the new campaign ideas"
"Add this to my workout note: [new exercise]"
"Edit the meeting note to include action items"
```

### Mobile Edit Features

* **HTML Compatibility**: Notes created on web (with rich formatting) are automatically converted to plain text on mobile
* **Tag Preview**: See tags as visual chips before saving
* **Change Detection**: Save button only enables when you make changes
* **Memory Info**: View note type, creation date, and detected language

### Deleting

* **Mobile**: Swipe left on note → Delete
* **Web**: Open note → Delete button (bottom-left) → Confirm

**AI-Assisted Deletion**:

```text theme={null}
"Delete my old workout note"
"Remove the note about the cancelled meeting"
```

### Attaching to Chat

Send notes to chat for AI analysis:

1. Hover over a note card in Library (web)
2. Click the **(+)** button
3. The note is attached to your chat context
4. Ask Qwox to "Summarize this", "Extract key points", or "Rewrite this"

## Best Practices

<AccordionGroup>
  <Accordion title="Use Descriptive Titles" icon="heading">
    "Marketing Team Meeting - Jan 15, 2024" is better than "Meeting Notes"
  </Accordion>

  <Accordion title="Add Tags Consistently" icon="tags">
    Develop a tagging system and stick to it for easy organization.
  </Accordion>

  <Accordion title="Leverage Collections (Web)" icon="folder">
    File notes into projects or topics for better organization.
  </Accordion>

  <Accordion title="Use Rich Formatting (Web)" icon="text">
    Tables, headings, and lists make notes more readable and scannable.
  </Accordion>

  <Accordion title="Stay Within Word Limits" icon="chart-bar">
    Free plan users should keep notes under 1,000 words or upgrade to Premium.
  </Accordion>
</AccordionGroup>

## Advanced Features

### Note Metadata

Every note automatically stores:

* **Detected Language**: Auto-detected from content
* **Searchable Text**: Pre-computed index (title + content) for fast search
* **Embedding Vector**: 768-dimensional vector for semantic search
* **Timestamps**: Creation and last update times
* **Source Tracking**: How the note was created (manual, AI agent, chat message)
* **Entities**: Structured data for collections (projects, people, locations)

### Unsaved Changes Protection

* **Change Tracking**: System detects modifications to title, content, tags, and collections
* **Warning Modal**: "You have unsaved changes" appears before closing
* **Keyboard Shortcut**: Pressing Esc triggers warning if changes exist
* **Confirmation Required**: Must confirm before discarding changes

### Modal Resizing (Web)

* **Drag to Resize**: Grab bottom-right corner to adjust editor size
* **Size Limits**: Minimum 600x500, maximum 1400x900 pixels
* **Persistent Size**: Your preferred size is remembered during the session

## Keyboard Shortcuts (Web)

| Shortcut | Action                              |
| -------- | ----------------------------------- |
| Cmd+S    | Save note                           |
| Cmd+B    | Bold text                           |
| Cmd+I    | Italic text                         |
| Esc      | Close editor (with unsaved warning) |
| /        | Open slash command menu             |
| ↑ ↓      | Navigate slash menu                 |
| Enter    | Select slash menu item              |

## Related Guides

<CardGroup cols={2}>
  <Card title="Memories" icon="brain" href="/guides/memories">
    Quick facts vs. detailed notes
  </Card>

  <Card title="Library" icon="folder" href="/guides/library">
    Browse and organize all content
  </Card>
</CardGroup>