A lightweight semantic annotation language for writers
MuseTag is a lightweight semantic annotation language that allows writers to organize their creative work directly within their text. It offers a simple syntax to track characters, locations, plot elements and their relationships, without interrupting the writing flow. Compatible with standard text editors and Markdown, MuseTag naturally integrates into the creative process while providing a structured view of the work. The annotations remain optional and human-readable, enabling authors to focus on their content while maintaining clear organization when needed.
For a comprehensive introduction, documentation and guides, please visit the MuseTag official website.
@@Jules(smiled) at @@Marie(25 years old) while she was reading.
In this example, "Jules" is annotated with a simple, unqualified note ("smiled") and "Marie" is annotated with an age ("25 years old")—both using the most basic MuseTag annotation syntax. Readers simply see:
Jules at Marie while she was reading.
You can also attach notes to entities, either locally or globally:
@@Marie(25 years old) smiled. # Local note
@@Marie_(red hair) # Global note
You can also use more advanced forms, for example:
@@Jules smiled at @@(Marie).age(25)her while she was reading.
Here, "Jules" is a visible entity and "Marie" is a hidden entity with a modifier (age) and a hidden parameter (25), while readers simply see:
Jules smiled at her while she was reading.
Try MuseTag instantly with our interactive demo! Edit example text in real-time and see how MuseTag annotations work—no installation required.
- Write naturally: Add annotations without leaving your text editor
- Track everything: Characters, locations, events, and their relationships
- Stay focused: All your notes right where you need them
- Keep control: Your text remains plain text, readable anywhere
- Build tools: Structured annotations enable powerful analysis tools
- Quick Start Guide - Start using MuseTag in 5 minutes
- Complete Specifications - For developers and advanced users
This project is licensed under the MIT License - see the LICENSE file for details.
Contributions are welcome! Please feel free to submit a Pull Request.