Search Operators
Learn how to use Beloga's special operators to reference specific documents and tags in your searches.
Document References (!)
Use the bang (!) operator to reference specific documents in your library.
Basic Usage
Syntax
!document-name.pdf - References a specific document
Examples
!meeting-notes.md- Reference meeting notes!research-paper.pdf- Include a specific paper!project-brief.docx- Reference a project document
Combining with Sources
Reference documents while searching specific sources:
Examples
@library "machine learning" !course-notes.pdf- Search notes with context from course notes@files "budget" !q4-finance.xlsx- Search files with reference to Q4 finance@web "research" !literature-review.pdf- Web search with paper context
Best Practices
Tips for Document References
- Use descriptive filenames for easier referencing
- Reference relevant documents to provide context
- Combine with sources for more precise results
- Use multiple document references when needed
Hashtags (#)
Use the hashtag (#) operator to filter content by tags.
Basic Usage
Syntax
#tag-name - Filters content by tag
Examples
#research- Find research-related content#project- Access project materials#meeting- Find meeting-related items
Tag Combinations
Combine multiple tags for more specific filtering:
Examples
#research #ai- Find AI research content#project #active- Find active projects#meeting #team- Find team meeting content
Using with Sources
Tags work seamlessly with source types:
Combined Usage
@library #meeting- Find meeting notes@files #research- Find research files@links #tutorial- Find saved tutorials
Advanced Usage
Multiple Operators
Combine different operators for precise searches:
Complex Examples
@library #research !literature-review.pdf- Search notes tagged as research with context from review@files #project !roadmap.md #active- Search active project files with roadmap context@web "machine learning" #ai !reference.pdf- Web search with AI context
Search Priority
Beloga processes operators in this order:
- Document references (!) - provides context
- Hashtags (#) - filters results
- Source types (@) - determines search scope
Context Enhancement
How Operators Work Together
- Document references provide additional context
- Tags filter and categorize results
- Sources determine where to search
Best Practices
Effective Tagging
Tagging Guidelines
- Use consistent tag naming
- Create tag hierarchies (#project-planning vs #project)
- Combine related tags
- Keep tags focused and specific
Document References
Document Reference Tips
- Reference relevant documents only
- Use specific document types
- Ensure documents are up-to-date
- Consider document content relevance
Search Strategy
Building Effective Searches
- Start with source type (@)
- Add relevant tags (#)
- Include document references (!) for context
- Refine based on results
Tips for Success
Tag Organization
Tag Structure
- Use project-specific tags (#project-name)
- Create status tags (#active, #completed)
- Add type tags (#document, #note)
- Include topic tags (#ai, #research)
Document Management
Document Tips
- Use clear, descriptive filenames
- Keep documents organized
- Update documents regularly
- Remove outdated references
Search Optimization
Search Tips
- Use specific tags over general ones
- Reference relevant documents
- Combine operators thoughtfully
- Review and refine searches