# Notes

> A notebook inside the keyboard: jot while you type, tag and pin, tick off checklists, lock the private ones, and keep every note in your backup.

URL: https://wmkeyboard.pages.dev/tools/notes/
Section: Tools

The **Notes** tool is a notebook that lives in the keyboard. Ideas, a diary, a shopping list, the thing someone just said in a call: write it down without leaving the app you are in, and find it again from any other app. Notes are plain text that the keyboard draws as Markdown, so a heading, a list or a `- [ ]` task box looks like one, and a task box can be ticked with a tap. Tags are buttons along the top of the list, so a tap on **Work** shows only the notes you filed under it.

The same notes are in the settings app, where a full-screen editor with a real text field is the better place to write anything longer than a few lines. Both sides write the same file, so a note made on the keyboard is in the app when you come back to it, and the other way round.

## Opening it

Notes is also a bundle on [Extensions](https://wmkeyboard.pages.dev/reference/settings/extensions/), as **Notes**. Off there, the tool, the quick note action and the notebook screens leave the keyboard and the app together; the notes stay on the phone.

Tap **Notes** on the toolbar, or in the toolbox if it isn't pinned (see [the toolbar](https://wmkeyboard.pages.dev/tools/overview/)). Tap it again to close it. Typing `notes` into a text field offers the tool as a chip on the suggestion strip, like every other tool keyword.

In the settings app the notebook is one tap from the tool's own page:

Tools / Notes / Your notes

**Add to home screen**, under it, puts an icon for the notebook on your home screen, which opens it straight away without going through the settings.

The panel opens on the list by default. Tools / Notes / The keyboard panel opens on can make it open on the note you edited last instead, which suits a running diary or a list you add to all day.

The panel takes the whole keyboard, the toolbar's row included, so the notes get as much room as there is. To keep your tools in reach while a note is open, turn on Tools / Notes / Keep the toolbar: the panel then opens under the toolbar, one row shorter. The back arrow in the panel's own header still goes back a step at a time, out of the note and then to the list, while the toolbar's back arrow closes Notes in one tap.

### Quick note

The **Quick note** action opens the panel straight on a new note, with the keys already typing into its body, so a thought goes down in one press. Bind it to a flick, a key's long press, a toolbar button's hold or the floating button. It's an action rather than a tool, so it never shows on the toolbar or in the toolbox: you'll find it under **Other** in those pickers. Fire it again while the note is up to close the panel.

Under the editor's Markdown chips, a quick note adds a row of your latest notes, the one you touched last first, which you can scroll sideways. Tap one to switch to it with the caret at its end, ready to add another line to a list you keep going, like the bugs you run into in an app. **New note** at the start of the row goes back to a fresh one. The note you leave is saved as it is; a new one you never typed into is deleted rather than left behind as an empty note, and the same happens when you close the panel or the keyboard. Locked notes, and notes too long for the keyboard's editor, stay out of the row.

## The shelf and the tags

The list is a shelf. Pinned notes sit on their own row at the top, as wide cards you scroll sideways, each washed with the colour of its first tag and striped along its edge; a note with no tag takes the theme's accent. The rest fill a two-column grid under them. A card shows the note's title, a line or two of its text, when it was last edited, and a dot for each tag; a checklist shows a small ring of how much is ticked, and a locked note a padlock. Cards arrive one after another as the panel opens, and squash a little under your finger.

Along the top, next to Back, the filter chips scroll: **All**, **Pinned**, one chip per tag, **Archived** and **Trash**, then **Manage tags**. The tag chips are your tags, in your colours; there are none until you make one. The round search button at the end turns the header into a search pill, which searches titles, tags and text as you type into it, the way the clipboard's search works; the keys type into the search rather than into the app behind the keyboard, and the chips move down under the pill so a filter stays a tap away. With [Search by meaning](https://wmkeyboard.pages.dev/smart/search-by-meaning/) on, notes that are about what you typed follow the matches, from the same chip; locked notes are left out of it.

Once the search holds two letters or more, the paragraphs that contain them come first, under **Passages**, above the notes. Each shows its paragraph with the match picked out and, under it, the note it comes from. Tap one to type that paragraph into the field as the note has it, without opening the note; hold it to open the note in the editor with the cursor on the match. A locked note, or one too long for the editor, opens to read instead. A long paragraph is cut down to the line around the match, and a long line to the sentences around it. One note gives three passages at most, a search lists 24, and locked notes give none.

Tap a card to open it. Hold a card for its actions right there on the card: **Insert**, **Copy**, **Edit**, **Share**, **Pin**, **Archive**, **Lock** and **Delete**. Swipe a card to the left instead for **Pin**, **Archive** and **Delete** behind it; a long swipe past about half the card moves it to the trash at once, with the Undo bar to bring it back. In the trash, the swipe shows **Restore**. Holding a tag chip opens the tag manager in the settings app.

A **Jot something…** pill floats along the bottom of the shelf. Tap it, or its **+**, to start a new note; it steps aside while the Undo bar is up. On an empty tag, the empty list offers **New note tagged** with that tag already on it.

### The timeline

Tools / Notes / Keyboard panel layout swaps the shelf for a timeline: a rail of days down the left, **Today** and **Yesterday** first and dates after them, with one compact row per note beside it, newest first. A row leads with the checklist's ring, a padlock, or a text glyph in the tag's colour, then the title with a pin when the note is pinned, a line of its text with the checklist's count in front, its tag pills, and the time for today's notes or the weekday for the rest of the week. The chips, the search, the swipes and the holds work the same, and a round **+** button in the corner starts a new note. The shelf is the default.

## Writing a note

A new note opens its editor with the title line focused: type a title, press Enter, and you are in the body. A title is optional. A note with none is named after its first line, with the Markdown taken off, so `# Shopping` on the first line is a note called Shopping.

The editor collapses the panel so the key rows come back underneath it, the way the clipboard's clip editor does. Enter is a line break. Inside a list it carries the list on: `- ` after a bullet, `3. ` after `2. `, a fresh `- [ ] ` after a task box, and Enter on an empty item ends the list. The editor has no long-press menu of its own, so the row of chips above the keys opens with **Paste**, which types what you last copied into the note at the caret (over any selection), the same text a paste key on the layout would. After it, the chips insert the Markdown you reach for most: bold, italic, a bullet or a numbered list, a task box, a heading, a quote and code. Each one wraps whatever is selected, or toggles its prefix on the lines you selected. The row's end counts your words and characters.

Everything you type is saved as you go. There is no Save button and nothing to lose when the keyboard closes or another app takes the field: the draft is written first. **Done** keeps the note and goes back to reading it; **Cancel** puts the note back the way it was when you started, and throws away a new note altogether. A new note left blank is not kept.

Tags sit above the body. Tap one to take it off the note, or **+ Tag** for the picker: your other tags first, then a few starters (Important, Work, School, Study, Personal, Ideas) until you have tags of your own, and **New…** to type a name. A tag is made the first time it goes on a note.

## Reading a note

An open note is its card grown to fill the panel: its tag pills along the top with when it was edited at the right, the title large, and the note under it. Tapping a tag pill filters the list by that tag. Along the bottom sit **Insert**, **Edit**, **Copy** and **Share**; in the header, **Pin**, **Lock**, the arrows that make the note taller, and **More**, which unfolds a row with **Pin**, **Archive**, **Lock** and **Delete**. Back shrinks the card into the shelf again.

The reading view draws the note as Markdown: headings (including the `===` and `---` underline kind), lists, nested quotes, tables, footnotes, strikethrough, links, code blocks with their keywords, strings and comments coloured, LaTeX maths between `$` or `$$` signs, and task boxes you can tick and untick. A link opens in your browser; a bare address like `https://example.com` is a link too. An image shows its description until you tap it, and only then is the picture downloaded, so reading a note never contacts a server on its own. Ticking a box rewrites that one line of the note, so the text behind the view always says what the view shows. Tap anywhere in the text to edit from that line. Hold a word to select it, as in the [Wikipedia](https://wmkeyboard.pages.dev/tools/search/) reader: drag the handles to take more, then **Copy**, **Insert**, **Select all**, or **Ask AI** about the passage when the AI tool is on. The settings app's Preview selects text the same way, with the phone's own Copy bar. The bar under the note holds the same actions the list offers: **Insert** types the note into the field behind the keyboard, as it was written; **Copy** puts it on the clipboard; **Share** hands it to another app through the [share sheet](https://wmkeyboard.pages.dev/reference/settings/share-sheet/), whose **Insert** types it into the field too. The arrows in the header make the note taller, up to most of the screen, for reading something long. A locked note, or one in the trash, keeps a row of chips instead, with only what it may do.

A long note shows its first part and a **Show more** chip. A very long one, past twenty thousand characters, still reads here but edits in the settings app, where the Edit chip takes you.

Tools / Notes / Format Markdown turns the formatting off, for anyone who would rather see exactly what they typed.

## Pin, archive, trash

**Pin** keeps a note at the top of every list, whatever the sort order. **Archive** takes a note out of the main list without deleting it: it waits under the **Archived** chip and still turns up in a search of that chip. **Delete** moves a note to the **Trash**, and an Undo bar gives you a few seconds to change your mind; the trash itself is the longer undo, with **Restore** on every note in it. Notes in the trash are deleted for good after thirty days, or after seven or ninety, or never, under:

Tools / Notes / Keep trashed notes for

**Delete forever** and **Empty trash** ask for a second tap. In the settings app the same actions are on each note's menu, and the list there has a select mode: hold a note, tick the others, and pin, archive, tag, lock or trash them together. Swiping a note to the left shows **Pin**, **Archive** and **Delete** behind it for that one note, and a long swipe past about half the row moves it to the trash straight away, with the same Undo bar. In the trash, the same swipe shows **Restore** and **Delete forever**.

The sort order, last edited by default, is Tools / Notes / Sort notes by.

## Locked notes

A note can be locked, from its actions on the keyboard or from the menu in the app. A locked note shows its title and nothing else in every list, and the keyboard never shows, inserts, copies or shares its text. In the settings app it opens only after the same check the [app lock](https://wmkeyboard.pages.dev/reference/settings/app-lock/) uses: your fingerprint or screen lock, or the PIN, password or pattern you set there, and taking the lock off asks too, whether from the note's menu or for several notes at once in select mode. Opening a locked note asks once; if the whole Notes screen is already behind the app lock, it does not ask again.

This is a lock on the screen, not on the data. The note is stored like any other note, so a backup file, Android's own backup, or a computer with USB debugging still reach it. To keep a locked note out of the backup file, see [Backups](#backups) below. On a phone with no fingerprint and no screen lock set up, there is nothing to ask for, and locked notes open with a caption that says so.

## Save a selection as a note

With [selection actions](https://wmkeyboard.pages.dev/smart/selection-actions/) on, selecting text in any app offers **Save as note** on the bar. It saves the selection as a new note and says so with a toast, leaving the field as it was. Tools / Notes / Save as note from a selection can make it add the selection to the end of the note you edited last instead, which turns a day of selections into one running note.

Nothing is saved from a password field, and nothing can be saved before the phone's first unlock after a restart, since the notes file is behind the lock screen until then.

## Save from another app's share sheet

Tools / Notes / Save to notes from other apps

Share text from any app and pick **Save to notes**: it becomes a new note, with the share's subject, when there is one, as the title. This works with the keyboard closed, and with no selection actions needed.

Share a link instead, a page from the browser's Share menu for instance, and it becomes a read-later note. The keyboard reads the page once, keeps its title and its text with the layout taken off, puts the link at the top, and tags the note **Read later**, so the tag's filter gathers everything you saved for later. The [Read back](https://wmkeyboard.pages.dev/tools/read-back/) tool can then read it to you. There is no JavaScript, so a page that draws itself with scripts comes back short; a page that cannot be read at all, or the build with no internet, saves the link alone, and the toast says which. The page request shows in the [network activity log](https://wmkeyboard.pages.dev/privacy/network-activity/) as **Notes: a shared page**. Data saver leaves it alone, since it is one page you asked for.

The switch above takes **Save to notes** out of the share sheet. It is on by default.

## Export, share and import

In the settings app, a note's menu shares it as a Markdown or a plain text file, named after its title. **Export all as a zip** under the list writes one Markdown file per note, archived notes included and locked notes left out, with the note's tags on a `Tags:` line at the end. **Import text files** reads `.txt` and `.md` files back as notes, one per file, each titled by its file name unless it opens on a heading (a file this app exported comes back as it went out), skipping any that already exist word for word, and reads a `Tags:` last line back as tags. A note holds up to 100,000 characters, and a longer file is cut there.

Importing is also the way to keep texts you quote often within reach: a speech, a book's chapter, a set of answers you give again and again. Give them a tag such as **Quotes**, and the search's [passages](#the-shelf-and-the-tags) type a quote from them straight into a chat. Pick the tag's chip while you search to look in those notes only. The [clipboard's search](https://wmkeyboard.pages.dev/tools/clipboard/#searching-your-notes-too) lists the same passages above your clips, so you can reach a quote without leaving the clipboard.

**Export to an Obsidian vault** asks for the vault's folder and writes each note to a `WM Keyboard` folder inside it, with its tags and dates in front matter so Obsidian sees them, and any space in a tag turned into a dash. It leaves out locked notes the same way. Export again to update the files: a note whose file is there overwrites it, so edits made to that file in Obsidian are lost, and a note you renamed gets a new file beside the old one. It runs when you tap it, not in the background. Import reads those files back, tags and dates included, and leaves front matter with any other key in the note's text.

## Backups

Notes are a section of the [backup file](https://wmkeyboard.pages.dev/privacy/backup/), on by default for the automatic backup and for sync between phones. Every note, its tags and the trash travel in it, except locked notes, which stay out unless **Include API keys** is on: a backup file is easy to send yourself or drop in a shared folder, and a locked note is one you asked to keep from view. Restoring a backup that left locked notes out keeps the ones already on the phone.

## Privacy

Notes stay on the phone. Nothing is sent anywhere unless you tap an image in a note to load it, share a link to **Save to notes** (which fetches that page), share a note, export the zip or to a vault, or back the file up to a location you chose. The keyboard never learns from a note: what you type into it does not reach your personal dictionary, your word pairs or your typing statistics. The tool is not available before the first unlock after a restart, when the keyboard has no access to its files.
