The editor

Noted's editor is built on TipTap. You write in a rich surface, but what is saved is a plain .md file, so your notes stay portable. Vaults made by earlier versions hold HTML inside those files; you can convert them to real Markdown at any time (see Note format).

Title-first writing

The first line of every note is its title. When a note is empty, the first block shows the placeholder "Title"; the next block shows "Start writing…". Press Enter after the title to drop into the body — the same muscle memory as Apple Notes.

The title is not metadata you fill in separately. It is simply the first line, styled as a heading.

Autosave and save status

Noted saves as you type. Edits are written after a short debounce (about 600 ms), and a status pill shows the current state:

• Saving — a write is in flight
• Saved — everything is on disk
• Save failed — the last write did not succeed

Press ⌘S to force an immediate save. Writes are atomic and flushed to disk (fsync), and a quit is held until the last autosave has flushed, so ⌘Q never drops an in-progress edit.

The title becomes the filename

By default, the note's filename follows its title. A moment after you stop typing in the title (about 900 ms), Noted renames the underlying .md file to match — collision-safely, and without reloading the editor or moving your cursor. This keeps the vault readable from any other Markdown tool.

You can turn this off with Settings → Editor → "Title follows filename". A manual rename in the sidebar also pauses auto-sync for that note.

Formatting

Three ways to format text:

• Toolbar — headings (H1/H2/H3), bold, italic, strikethrough, inline code, bullet and ordered lists, blockquote, insert table, find-in-note, search all notes, and an AI toggle. Hide it with Settings → Editor → Show toolbar.
• Bubble menu — select text and a small menu appears with bold, italic, strikethrough, and inline code.
• Keyboard — the shortcuts below.

Shortcut	Action
⌘B	Bold
⌘I	Italic
⌘E	Inline code
⌘⌥1 / ⌘⌥2 / ⌘⌥3	Heading 1 / 2 / 3
⌘Z / ⌘⇧Z	Undo / Redo

Blocks and rich content

• Headings, lists, blockquotes, horizontal rules — the standard structure.

• Tables — insert a 3×3 table from the toolbar; columns are resizable.

• Code blocks — with syntax highlighting for the common languages (powered by lowlight).

• Math — LaTeX math is rendered with KaTeX.

• Images — paste or drag an image into the editor (PNG, JPEG, GIF or WebP, up to 25 MB). It is saved as a file in the vault's attachments/ folder under a name made from its content (the same image is stored once), and the note keeps only the relative path, e.g. attachments/3f2a….png. Notes stay small, Git diffs stay readable, and the full-text index and MCP clients see a path rather than megabytes of base64. Deleting a note offers to remove the images only that note used (they go to the system Trash). Exports (PDF, HTML, Word, Markdown), printing and gists embed the images again so the result stands alone.

  Notes written by older versions have their images embedded in the text. Settings → Editor → Move embedded images out of notes… moves them to files: it first reports how many images in how many notes would move, and every changed note keeps a history snapshot, so it can be undone. The folder name is configurable in the same place.

• Typography — smart quotes, dashes, and similar substitutions are applied as you type.

Find in a note

Press ⌘F to open the find bar. It shows the current match position (3/12), and you can step through matches with Enter and Shift-Enter.

Focus and typewriter modes

• Focus mode (⌘\) hides the surrounding chrome so only your note remains.
• Typewriter mode (enable in Settings → Editor) keeps the current line vertically centered as you write.

A live word count is shown in the corner of the editor.

AI while you write

The editor also hosts Noted's inline AI: ghost-text completions, the / slash menu, and the AI actions bar. Those are covered in AI assistant.

Next steps

• Organizing notes — links, tags, projects, folders, and daily notes.

Note format

Noted stores each note as one .md file. Which language is inside it is a property of the vault:

• HTML (vaults made by earlier versions): the file holds the editor's HTML. It opens fine in Noted and in a browser, but other note apps show markup instead of text, and Git diffs are noisy.
• Markdown: the file is ordinary Markdown with YAML frontmatter, wikilinks ([[Note]]), ==highlights==, callouts, tables and task lists. Obsidian, VS Code and any text editor read and edit it, and a Git diff shows the words that changed.

Nothing converts by itself. To convert, open Settings → Editor → Note format → Convert to Markdown…. Noted first shows a report and changes nothing:

• how many notes convert exactly, how many keep a part as raw HTML (a <details> block, a superscript) and how many lose some formatting such as colours or merged cells;
• the name of every note that is not exact, with what is different;
• a note whose text would be lost needs a second, explicit yes; a note that cannot be read at all stops the conversion before anything is written.

When you confirm, Noted saves what you were typing, makes a zip copy of every note in .noted/backups/, keeps each note's old text in its version history, and rewrites the notes one by one, reading each back. If anything fails, every note is put back exactly as it was. The note you have open is read-only while this runs. The same screen has Convert back to HTML… if you change your mind.

The MCP server and the importers follow the vault: in a Markdown vault an assistant's create_note stores Markdown, and read_note returns it. A vault synced with Git carries its format with it (the .noted-vault.json file), so another computer reads it the same way.