Tags & Search

​

Full-Text Search

​

Opening Search

​

Search Behavior

1. Debounced: Waits 180ms after you stop typing
2. Full-text: Searches note titles and content
3. Ranked results: Most relevant notes appear first
4. Live updates: Results refresh as you type

​

Search Syntax

​

Basic Search

project alpha

​

Phrase Search

"user interface design"

​

Keyword Matching

• Individual terms: Each word is a search term
• Minimum length: Terms must be 2+ characters
• Stopword filtering: Common words like “the”, “a” may be filtered

​

Search Results

• Note title: Name of the matching note
• Snippet: Preview of matching content with highlights
• Relevance score: Higher scores appear first
• Match context: Surrounding text for context

​

Ranking Algorithm

​

Keyword Overlap

• Counts how many search terms appear in the note
• Higher overlap = higher score

​

Trigram Similarity

• Compares character trigrams between query and content
• Handles typos and fuzzy matching

​

Phrase Bonus

• If the exact query phrase appears, boost the score

​

Title Bonus

• Notes with query terms in the title rank higher

score = (0.6 × overlap) + (0.4 × trigram) + phrase_bonus + title_bonus

​

Tags

​

Tag Syntax

# Project Notes

#project #important #2024

This note contains three tags.

• Start with #
• Contain alphanumeric characters, dashes, underscores
• Not contain spaces (use - instead: #project-alpha)

​

Nested Tags

#projects/alpha
#projects/beta
#work/client/acme

​

Frontmatter Tags

---
tags: [project, draft, urgent]
---

# Note Content

​

Tag-Based Search

​

Filtering by Tag

1. Open search
2. Select one or more tags
3. Results narrow to notes with those tags
4. Optionally add a text query

​

Tag Autocomplete

• Existing tags in your space
• Tag counts (how many notes use each tag)
• Nested tag paths

​

Multiple Tags

• Tag #project AND #urgent
• Shows only notes containing both tags

​

Combined Search

Query: "user interface"
Tags: #project, #draft

1. Contain the phrase “user interface”
2. Have both #project and #draft tags

​

Tag Browser

• Tag name: The full tag text
• Count: Number of notes using this tag
• Sorted: By count (most used first) or alphabetically

​

Advanced Search

​

Search Options

• query: Text to search for
• tags: Array of tags to filter by
• title_only: Search only note titles
• tag_only: Search only tags (no content)
• limit: Maximum results (default: 50)

​

Example Searches

invoke("search_advanced", {
  request: {
    query: "meeting",
    title_only: true
  }
});

invoke("search_with_tags", {
  tags: ["project", "active"]
});

invoke("search_advanced", {
  request: {
    query: "design system",
    tags: ["ui", "reference"],
    limit: 20
  }
});

​

Indexing

​

Automatic Indexing

• On save: Every time you save a note
• On create: When you create a new note
• On delete: When you delete a note
• On rename: When you rename a note

​

Index Contents

• Note title: Filename without extension
• Note content: Full markdown text
• Tags: Both inline and frontmatter tags
• Paths: Relative path in your space
• Timestamps: Created and updated times

​

Rebuild Index

​

Recent Notes

invoke("recent_notes", { limit: 10 });

• Quick access to recent work
• “Continue where you left off” features
• Recent activity timeline

​

Performance

​

Search Speed

• SQLite FTS5: Full-text search engine
• Indexed queries: Sub-100ms for most queries
• Candidate limiting: Fetches top 300 candidates, then ranks
• Debounced input: Reduces unnecessary queries

​

Scaling

​

Troubleshooting

​

Search returns no results

1. Check spelling and try synonyms
2. Simplify your query (use fewer words)
3. Rebuild the search index
4. Verify the note exists in your space

​

Search is slow

1. Reduce query complexity
2. Use more specific search terms
3. Filter by tags to narrow results
4. Rebuild index if it’s corrupted

​

Tags not appearing

1. Ensure tags start with #
2. Check for spaces (use #tag-name not #tag name)
3. Save the note (tags index on save)
4. Rebuild index if needed