Notepad tool
The canonical version always lives at https://tavina.ai/docs/friendly/tools/notepad
Notepad tool
Notepad is a Standard tool: it sits in the default toolbar from the first login (toolbar label Notepad), and if you hide it while customizing the toolbar you can re-enable it yourself from Settings β Appearance β Toolbar β no request or grant is needed.
The Notepad tool is Tavina’s place for lightweight writing: notes organized in collections, with fast search across everything you have written, visual formatting up to and including tables and callouts, tags, templates, and backlinks, favorites, and edits you can always recover.
Use Notepad for information you want visible and editable, but not structured enough to become a task, calendar event, or Knowledge Library Source. It stays deliberately simple β it is not Notion or a long-document editor.
What you see in the PWA
Open Notepad from the toolbar. Notepad fills the whole work panel with one writing workspace (tavina/tavina#1968):
- One editor β a single editor fills the panel and resizes automatically when you move the chat divider, minimize chat, rotate the device, or go fullscreen. The old draggable collection grid and the separate expanded editor window are retired; there is no second window and no lost controls when the layout changes.
- Collection switcher β a compact, searchable switcher at the top for moving between collections such as
House,Ideas, orTrip, with actions for creating collections and moving them up or down into the order you want. - Optional sidebar β a pinned collections sidebar you can show or hide on wide panels (renaming, icon changes, deletions, and reordering live here); on narrow panels it behaves as an overlay drawer. It is optional β there is no mandatory three-column layout.
- Note tabs β the notes of the open collection appear as tabs, bounded to at most two rows, with a +N more control for deeper pages.
- All notes β a picker that searches every note you have β titles and note text, across every collection at once β and opens the exact note you pick; favorites and recently opened sections are here too.
- Save status β feedback showing whether the current edit is saved, saving, or unsaved, plus clear notices when a save fails or a conflict needs your decision.
Keyboard and accessibility
- Move between note tabs with the arrow keys; Home and End jump to the first and last tab; Ctrl/Cmd+S saves immediately.
- The switcher, sidebar, tabs, All-notes picker, and every editor control are reachable by keyboard and labeled for screen readers.
- Focus mode hides the navigation so the editor fills the panel, but the save, copy, find, and history controls always stay visible and reachable.
Create collections
Create a collection when notes belong together. For example:
Housefor door codes, paint colors, and maintenance notes.Ideasfor quick brainstorms.Mealsfor simple meal notes that are not full recipes.Tripfor packing reminders and addresses.
A collection without an icon shows a friendly default instead of a broken image, and collections created with an emoji icon keep their emoji (tavina/tavina#2136).
Avoid creating too many collections. If you cannot tell where a note belongs, use a general collection and reorganize later. Collections keep the order you give them: move a collection up or down from the sidebar or the switcher, and the new order sticks across your devices, so the collections you reach for most stay within easy reach.
Create and edit notes
- Open Notepad.
- Choose the collection.
- Create a note.
- Type or paste the note content.
- Watch the save status: edits save automatically a moment after you stop typing, you can press Ctrl/Cmd+S to save immediately, and if it says anything other than Saved your text is still protected on your device until the save goes through.
Keep notes short enough to scan. If a note becomes a document, upload it to the Knowledge Library instead. If it becomes a to-do list, convert it into Tasks.
Visual formatting (bold, headings, lists, checklists, links)
Notes can now be formatted visually, without knowing any Markdown (tavina/tavina#1972):
- Toolbar formatting β select text and click bold, italic, or a heading level, turn lines into bullet or numbered lists or checklists, or insert a link. Undo/redo and your usual keyboard shortcuts keep working. Raw HTML is never allowed, and links are limited to safe web and email addresses (
http,https,mailto) β unsafe link types cannot be inserted. - New notes start formatted by default (tavina/tavina#2139). You can set a different default for yourself or for a single collection (see below) β and plain text remains available as an explicit choice. Existing notes stay exactly as they are: a note you already wrote opens as before, and only becomes formatted when you deliberately convert it (converting back is equally deliberate); conversion is history-snapshotted so it can be undone like any edit.
- Conversion is lossless. Turning a plain note into a formatted one keeps characters that merely look like Markdown (asterisks, hashes, dashes) as literal text, so a note full of
*or#displays exactly as typed.
How formatting is stored (the deliberate design)
A formatted note is stored as its Markdown source β a small, bounded subset: bold, italic, headings, bullet and numbered lists, checklists, links, tables, callouts, images, footnotes, and code. Nothing else is interpreted, and there is no hidden binary format.
This choice is deliberate (documented per tavina/tavina#1972):
- Agents and the API still see ordinary text. Reading a formatted note through the app, the API, or your agent returns the same Markdown-subset source β plain text that can be read and edited as usual. Agent edits remain revision-checked and never lose your formatting silently.
- Copy and export match what you expect. Copy gives you plain text as displayed (markers removed) or the formatted Markdown source; export downloads a
.md(formatted) or.txt(plain) file. Copying plain text from a formatted note is a one-way convenience; it is not a conversion back to a plain note. - Plain notes are never rewritten. The two formats live side by side; nothing scans your existing notes or converts them in the background.
- Your agent can convert a note for you on request (for example, “make this note formatted”), using the same explicit, recoverable conversion the app uses.
Reference formatting (tables, callouts, images, footnotes, code)
Notes can hold more than prose. The same bounded formatting grew a reference-document layer (tavina/tavina#2391), so a note can carry a small table, a warning box, an image, a footnote, or a command β and still be plain Markdown underneath:
- Tables β pipe-style rows and columns, for comparison grids, dosage tables, or quick reference sheets. Enter them as Markdown lines; they render as a proper table.
- Callouts β highlighted boxes for note, tip, warning, and danger. Type them as quoted Markdown lines such as
> [!warning] Check the dosage before use.β useful for safety-critical notes your agent reads back to you. - Images β you can add a picture two ways (tavina/tavina#2459). Upload an image and it is stored safely inside your Tavina account β large photos are automatically resized and compressed before storage, and you can check how much image storage you are using in Settings. Your agent can also insert a stored image into a note for you, and can import an image you have sent in chat so it lands in the same safe storage (tavina/tavina#2569). By web address β
shows a picture hosted elsewhere; only safe web addresses are accepted. If a web address is unsafe or unavailable, the note shows the description text instead.
- Footnotes β small markers like
[^1]with their footnote text at the bottom, for sources and asides without cluttering the body. - Code β inline code between backticks and fenced code blocks for commands, formulas, and literal text that must not be reformatted.
The same five pieces render in the Knowledge Library’s source preview too (see below), so a reference note and a library Source share one look. Everything stays readable as plain text: raw HTML is still never allowed, and nothing is hidden in a binary format. Your agent can write and read these notes as ordinary text, the same as any other note.
Comfortable writing: font, text size, and column width
Notepad has writing view preferences, separate from formatting (tavina/tavina#1973). They change how notes look for you, never what the note says:
- Writing font β choose a serif, sans-serif, or monospace font for the editor from a small, sensible set. All options are local system fonts; Tavina does not download fonts or send requests to font services.
- Text size β make the editor text larger or smaller in steps from 80% to 160% of the default, with a Reset back to normal.
- Readable or wide column β Readable keeps the text in a comfortable centered column; Wide lets it span the full panel.
They are viewing preferences, so:
- Changing any of them never changes your note β no edit, no revision, no history entry, and agents see the note exactly as before.
- They follow your account across devices, like Favorites, through your normal settings. The editor itself always fills the work panel; only the text column width changes.
Default format for new notes
Formatting new notes work out of the box: links, bold, and lists display the moment you write them (tavina/tavina#2139, tavina/tavina#2141, tavina/tavina#2142). If you prefer plain text, Notepad lets you choose the default at three levels, with the most specific winning:
- A collection’s default β set per collection from the collection’s menu, so
Code Snippetscan stay plain while everything else stays formatted. Clearing it falls back to the next level. - Your Notepad default β chosen in Notepad settings (the gear icon); rich formatting is the standard choice and plain text is a deliberate opt-out.
- The Tavina standard β rich formatting, when you have not chosen otherwise.
An explicit choice at creation always wins over any default. Changing a default never rewrites existing notes β it only shapes the notes you create afterwards.
Notepad settings
Open settings with the gear icon in the upper-right corner of the Notepad panel (tavina/tavina#2142). Settings live in one tidy place and follow your Tavina account:
- Default format β
rich (markdown)orplain textfor the notes you create (see above for how defaults stack). - Notes background β
yellow legal pad(the familiar default),white legal pad, orplain white.
The settings window is the home for future Notepad preferences, so new options will appear there instead of scattered across the editor.
Move a note between collections
A note’s menu (β―) now offers Move to collectionβ¦ with a picker for the destination (tavina/tavina#2140). Moving keeps the note’s identity β same note, same formatting, and its entire history travels with it β so links, favorites, and reminders that point at the note keep working. A move is revision-checked like any edit: if the note changed just before the move, you are asked to retry rather than having anything overwritten. Moving is reversible; move the note back any time. Your agent can move notes on request the same safe way.
Convert a whole collection at once
Converting every note in a collection no longer means converting them one by one (tavina/tavina#2141). One operation converts each note in the collection to formatted (or plain), and each note keeps its own recoverable history entry. Notes that changed at the same moment are never forced: they are skipped and reported, so you or your agent can look at them individually. You can also ask Tavina in one sentence β “convert all the notes in Ideas to formatted” β with the same guarantees.
Tags, templates, and backlinks
Collections group notes; tags connect them (tavina/tavina#2393):
- Tags β free-form labels on any note, shown as small chips under the title. Tap a tag in the All-notes picker to see every note carrying it, across all your collections. Search matches whole tags exactly, and can be combined with normal text search. Tags are ordinary metadata: your agent can add, change, or search them on request.
- Templates β reusable note skeletons. Save a note’s shape as a template, then create new notes from it β a weekly-review outline, a plant-care card, a meeting format. A collection can also have a default template, so every new note there starts with the skeleton. A template can include
{{title}}and{{date}}placeholders; when a note is created from it, each becomes the new note’s title or that day’s date (tavina/tavina#2456). Anything else in the skeleton lands as written, and a template only pre-fills β once created, the note is a normal note you can edit freely. Deleting a template asks for confirmation first and does not touch notes made from it. - Backlinks β write
[[Another note title]]inside a note to point at that note, and the note you pointed at grows a Linked from panel listing every note that references it. References your agent writes into a note count too, whichever syntax they use (tavina/tavina#2454). Self-references are ignored. Backlinks are lightweight references, not a database β if a referenced title disappears or is renamed, the panel simply stops listing it rather than breaking.
Keep your notes in order: duplicate, bulk move, pin, and sort
Everyday housekeeping has one-click answers (tavina/tavina#2395):
- Duplicate β a note’s menu offers Duplicate, creating an independent copy with the same content, format, and tags. The copy gets ” (copy)” added to its title and starts with a fresh history of its own β the original’s history is never copied, so the two notes diverge cleanly from day one.
- Bulk move and delete β select several notes at once and move them to another collection or delete them together. A bulk move keeps each note’s identity and full history, checks every revision first, and aborts cleanly β with nothing moved β if any note changed in the meantime. A bulk delete confirms first and makes every deleted note individually restorable from Recently Deleted, exactly like single deletions. Your agent can do the same bulk operations on request, with the same confirmation and recovery.
- Pin β pin a note to keep it at the top of its collection. Pinning is deliberately separate from Favorites: a pin orders the note within its collection, while a favorite pins it to your account-wide sidebar list. Pinned notes stay first across every sort mode, and pinning never creates a history entry β it only changes how the collection is ordered.
- Sort per collection β each collection remembers your chosen sort: manual order, last updated, created, or title. Choose it from the collection’s sort control; the choice follows your account. Manual drag-to-reorder stays available in manual mode, and only for fully loaded collections, so a long collection is never silently half-reordered.
Navigate long notes: table of contents and anchors
Notes with several headings get a table of contents automatically (tavina/tavina#2398):
- A note with two or more headings shows a contents sidebar that lists those headings; click one to jump straight to it.
- The contents update as you edit β add, rename, or remove headings and the list follows immediately.
- Every heading gets a stable anchor, so you can deep-link to a specific section: copy the link from the contents entry and share or bookmark it, and the note opens scrolled to that heading.
- Plain notes without headings show no sidebar β nothing changes for simple notes.
Limits and expectations
Notepad is intentionally simple. It is not Notion, a database, or a long-document editor. Current source behavior treats notes as lightweight collection items and includes safeguards around collection and note operations.
The published user-facing limits for this lightweight model are (tavina/tavina#1967):
- up to 200 notes per collection;
- up to 1 MiB per note, measured in UTF-8 bytes (so emoji and non-Latin text count toward the same envelope);
- the editor footer shows each note’s current size against that envelope in byte-based units.
Going over a limit is refused with a clear error instead of silently truncating. If you regularly need more than that, use the Knowledge Library for documents or split the material into multiple collections.
Exports respect the same envelope: a combined single-document export skips any note that would push it past a combined size bound and tells you which notes were skipped, rather than silently truncating content.
Fast loading for large collections
Notepad stays responsive as collections grow (tavina/tavina#1967):
- Opening Notepad loads the collection list and note titles first, not the full text of every note, so big collections open quickly.
- The note list pages through the collection in stable chunks; a +N more control loads the next page of note titles when you need them.
- Opening a note fetches only that note’s full text, on demand.
- Switching between notes you recently viewed is instant, because the last few notes (up to 10) are kept in a small in-memory cache.
Search across all your notes
Search in the All-notes picker now reaches everything you have written (tavina/tavina#1970):
- Typing matches both note titles and note text, across every collection at once β a word buried in a body shows up even when the title says nothing about it.
- Each result shows its collection name, so two notes with the same name stay easy to tell apart; picking a result opens that exact note, never a same-named twin from another collection.
- Results show a short excerpt of the matching text with the match highlighted; a note that matched only by title is labeled as a title match rather than showing a misleading snippet.
- Search treats what you type literally: percent signs and underscores find themselves, not wildcard patterns, and accented and non-Latin text matches exactly as typed.
- Results keep a consistent order page to page (most recently updated first), show up to 100 per page, and stale answers from an earlier keystroke never overwrite what you just typed.
- Closing the picker and opening it again brings back your last search and its results without redoing the search.
Your agent can search the same way: asking “find my note about the plumber” matches titles and text across collections, with the same excerpts, ordering, and account separation as the app.
Pick up where you left off
Notepad remembers where you were, so you do not have to hunt for the same note twice (tavina/tavina#1969):
- Your last note reopens automatically. When you open Notepad, it returns to the last note you had open, in the same collection β also after closing the app or reloading the page in your browser.
- Recently Opened keeps a short list of your ten most recent notes in the All-notes picker. Opening the same note again moves it to the front of the list instead of duplicating it.
- Favorites pins notes with the star icon so they stay easy to reach across all your collections. Favorites are saved with your Tavina account, so they follow you to other devices signed in as the same subscriber.
A few details worth knowing:
- Opening a note from Recently Opened or Favorites jumps straight to it, even when it lives in another collection β and it works from the keyboard as well as by touch.
- If a remembered note was renamed or moved, it opens under its current name and location.
- If a note or collection no longer exists, Notepad falls back safely instead of opening something broken, and cleans the dead entry out of its lists.
- Restoring a note from Recently Deleted reconnects it everywhere it was remembered β including pinned Favorites β even though the restored note has a new identity.
- Navigation memory is kept per device and per account: switching accounts or browsers never mixes up your lists.
- Notes your agent reads in the background do not crowd the Recently Opened list β only notes actually opened in the Notepad do.
Recover your deletions
Deleting in Notepad is recoverable by design (tavina/tavina#1964):
- Deleting a note or a collection always asks for confirmation first.
- A safety snapshot is created before anything is removed. If that snapshot cannot be created, the deletion is blocked and nothing is removed β Notepad never deletes unrecoverably just because recovery failed.
- Open Recently Deleted in the Notepad header to see your most recent deletions and restore any of them in one click.
- Restoring a note whose collection was deleted later brings the collection back too.
- Recovery keeps the most recent deletions per item, so much older snapshots can eventually be replaced. When that happens, the restore explains honestly that no snapshot exists β it is never treated as permission for an unrecoverable delete.
- When your agent deletes Notepad items on your behalf (after your confirmation), it receives a version id it can use with
versions_restoreto undo the deletion.
Safe simultaneous saves
Two people β or you and your agent β editing the same note at the same time can no longer silently overwrite each other (tavina/tavina#1965):
- Every save carries the revision of the note you read. If someone else saved first, your save is not applied.
- Instead, Notepad shows a clear conflict notice with the current version, offering Load latest version, Keep editing mine, Copy my version (to the clipboard), or Save mine anyway β your text is never quietly discarded and the other person’s edit is never quietly erased.
- Re-saving the exact same content does nothing new: no new version, no history entry.
- Agents get the same protection: your agent must present the revision it read, and a conflict returns the current note with guidance so it can re-read and retry instead of clobbering.
Recover your edits
Editing in Notepad is recoverable by design (tavina/tavina#1965):
- Every real save snapshots the previous note state first. If that snapshot cannot be created, the save is blocked and nothing changes β Notepad never makes an unrecoverable edit just because history failed.
- Open the note’s history with the History button (clock icon) in the editor footer, beside Search β it stays on the editor surface in every layout, including focus mode, and is disabled only when no note is open (tavina/tavina#2460). The note’s menu (β―) still offers History too. Either way, you see recent versions of that note and can restore any of them.
- Restoring an older version is itself protected: it requires a fresh revision check and never erases a newer edit. If the note changed meanwhile, the restore is refused with the current version.
- History keeps only the most recent edits per note, so storage stays bounded; older snapshots are replaced by newer ones and no longer appear.
- The Compare tab in the History window shows exactly what changed between any two versions β including the current note β as a unified or side-by-side diff (tavina/tavina#2143). Changed words are highlighted inside changed lines (tavina/tavina#2396), so a one-word fix in a long paragraph is visible at a glance instead of hiding inside a wall of changed text. Very large comparisons stay bounded: the diff emphasizes whole lines when a pair is too large for word-level detail, and very long diffs show the first few thousand rows with a clear notice rather than slowing the app. It shows what kind of change each version was (an edit, a format conversion, a move, or a restore), and restore this version uses the same revision-checked restore as everywhere else. Comparing is read-only: nothing changes until you choose to restore.
Reliable autosave and drafts
While you type, your draft is protected end to end (tavina/tavina#1966):
- What you type is kept on your device while the automatic save is still pending, and restored automatically if the app reloads or restarts mid-edit.
- Switching to another note, resizing the panel, or closing the Notepad panel first saves your in-flight typing instead of silently dropping it.
- If a save fails (for example you are offline or the server errors), your text stays in the editor, a clear notice with a Retry button appears, and nothing is lost while you fix the connection.
- When you choose Load latest version after a conflict, your own text is preserved as a restorable backup β a strip offers Restore my draft or Copy until you dismiss it.
- Drafts are kept only for your account and are cleared when you sign out or switch accounts.
Export a note or a collection
Notes are not locked inside Tavina (tavina/tavina#2397):
- Export a single note or a whole collection from the export menu on the note, the workspace footer, or the collection’s sidebar actions.
- Markdown β a formatted note exports exactly as stored, so tables, callouts, images, footnotes, and code all survive; a plain note exports as literal text. PDF β opens your browser’s print dialog with a clean, paginated document carrying a title-and-date header; use it to save or print. HTML β a standalone web copy of the rendered note.
- A collection export lets you choose one combined document or one file per note at export time.
- Exports are assembled in small steps, so even a large collection exports without loading everything at once. If a note is too large to include in a combined document, the export says so and skips only that note, listing what was skipped.
Working with Tavina in chat
Examples:
- “Add a note in House: garage keypad is 2468.”
- “Make a Trip collection and add a packing reminder for chargers.”
- “Find my note about the plumber.”
- “Open the vehicle specifications note.”
- “Pull up the garage keypad note.”
- “Turn the notes in Ideas into tasks.”
- “Summarize my notes in the Meals collection.”
- “What did the garage keypad note say before I changed it?”
- “Move the garage keypad note to the House collection.”
- “Convert all the notes in Ideas to formatted.”
- “Tag the garage keypad note as house and codes.”
- “Duplicate the packing list note so I can draft a version for winter.”
- “Move all the notes tagged trip-planning into the Trip collection.”
- “Make a template for my weekly review notes.”
Ask Tavina to open one exact note (tavina/tavina#1971):
- Say “open the garage keypad note” (or ask for a note right after a search) and Tavina opens Notepad straight to that exact note β identified by its stable id, so two notes with the same name are never confused and nothing is guessed.
- It works whether Notepad is already open or closed: an open Notepad simply navigates to the requested note, and a note that was moved to another collection is followed to where it lives now.
- If the requested note no longer exists, Tavina says so honestly instead of opening something else β your drafts and lists are left untouched.
- Focus mode is never hijacked. If you are in focus mode, Tavina defers instead of yanking a panel open, and suggests asking again once you leave focus mode.
- Stable links such as
?tool=notes¬e=open the exact note through the same safe path.
Review sensitive notes before asking Tavina to reuse them elsewhere.
Good habits
- Use Notepad for quick reminders, not private secrets.
- Keep one thought per note.
- Rename collections when their purpose changes.
- Delete notes you no longer need.
- Pin your most-used notes as Favorites instead of re-searching for them.
- Move long reference material to the Knowledge Library.
Related pages
If something goes wrong
- An edit seems lost β every save snapshots the previous note first; open the note’s history and restore. If the snapshot could not be created, Notepad blocks the save on purpose rather than losing your note.
- A deleted note is missing from recovery β Recently Deleted keeps only the most recent deletions; very old deletions age out. A safety snapshot is taken before anything is removed, and deletion is blocked if the snapshot cannot be created.
- Notes feel slow with a large collection β Notepad loads collections lazily; keep huge reference material in the Knowledge Library instead.
- Something still looks wrong β use the in-app Help support route; support can inspect account-side note state without your password. Never paste note contents or credentials into public channels.