Organizing notes

Noted keeps structure lightweight: links between notes, tags, a project namespace, nested folders, and a few generators (daily notes, templates). Everything is derived from the note files themselves.

Wikilinks

Type [[ to open an autocomplete of your existing notes. Pick one to insert a link rendered as [[Note name]].

• Click a wikilink to open it. If the target note does not exist yet, Noted creates it on the spot and opens it — dead links never lead to a dead end.

• With the cursor on a link, press Mod+Enter to follow it from the keyboard.

• A link can carry an alias and a heading: [[Note|shown text]], [[Note#Heading]], or both. They all count as links to Note.

• Headings and blocks. After [[Note# the autocomplete lists that note's headings; pick one (or keep typing to narrow them). Following [[Note#Heading]] opens the note with the caret on that heading, and the same for a block: put ^some-id at the end of a paragraph or list item and [[Note#^some-id]] leads to it. A heading is found whatever its case or spacing (#risks finds "Risks"), and [[Note#Part#Detail]] means the heading Detail under the heading Part. If the note has no such heading or block, the link still opens the note.

• Embeds. Put a ! in front of a link to show what it points at, in place, under that line: ![[Note]] the whole note, ![[Note#Heading]] the section under a heading (its sub-sections included), ![[Note#^block-id]] one block, and ![[photo.png]] an image (found by its path, or in the attachments folder; ![[photo.png|300]] sets the width). An embed is a read-only view: it is never saved into the note, so the file keeps only the ![[...]] you wrote. Click it to open the note it comes from, at that place. An embed of something that is not there says Not found. Embeds inside an embedded note are shown as written, not expanded.

• Renaming a heading. When you rename a heading and move on (the caret leaves it, the editor loses focus, or you open another note), the [[Note#Old heading]] links in other notes, by the note's name or one of its aliases, are updated to the new text; an alias after the | is kept. It follows the same Update links when renaming setting as renaming a note (Always, Ask, Never), and each changed note keeps a history snapshot, so it can be undone. Links inside the note itself are not touched, and nothing is done when a heading was added or removed at the same time, because which heading became which cannot be told.

• Aliases. A note can have other names, in its frontmatter (the Obsidian way):

  ---
  aliases: [Start, Landing page]
  ---

  [[Start]] then opens that note, counts as one of its backlinks, and Quick Open finds the note by it. A link that names a note (or its path) always wins over an alias; if two notes share an alias, the one in the same folder as the note holding the link is used, then the one with the shortest path. alias: works too, and so does a list written over several lines.

Renaming and moving notes

Rename or move a note, or rename or delete a folder, and the links that pointed at it are rewritten in the other notes ([[Old]], [[Old|alias]] and [[Old#Heading]] all become [[New…]]), so nothing is left dangling. Every note that changes keeps a snapshot of its previous text in its history, so the change can be undone.

When the name comes from the note's title, Noted does not rewrite links on every pause while you retype it: it waits until you stop, switch to another note, leave the window, or quit, and then rewrites them once, from the original name to the final one.

The Update links when renaming setting (Settings → Editor) picks Always (default), Ask (a prompt tells you how many links in how many notes would change) or Never. With Ask, a held-back title rename asks when it settles, and not at all on quit.

Backlinks

When other notes link to the current one, a Linked from panel appears below the editor listing each source as a chip. Click a chip to jump to that note. Backlinks are computed automatically from the links in your vault.

The connections panel

Open the Connections tab in the right panel to see how the current note relates to the rest of your vault, in four sections:

• Same project — notes that share a #project/<name> tag with this one.
• Linked from — backlinks.
• Links to — the wikilinks this note points at.
• Unlinked mentions — notes that write this note's title (or one of its aliases) as plain text without linking to it, each with the line of context it appears in. Link turns the first mention in that note into a [[link]] (written as [[Title|the words used]] when they differ from the title); the note then moves up to Linked from. Names inside code, links, URLs, tags, math and front matter are not mentions, and a note's earlier text is kept in its version history. Names shorter than three characters are ignored.

When a note has no connections yet, the panel invites you to add a [[wikilink]] or a #project/name tag.

Tags

Write #tag anywhere in a note. Typing # opens a tag autocomplete. Tags accept one optional namespace segment — #project/website is a single tag, while a second slash is not part of it.

The sidebar has a tag filter: click the tag icon to reveal your tags as chips and filter the note list to a single tag.

Projects

A project is just the #project/<name> tag, with one convenience on top. When you give several notes the same title, Noted notices and offers to group them: a banner appears above the editor —

N notes are named "…" — group them into a project?

Accepting adds the #project/<name> tag to the current note and to every matching note at once. From then on they show up together under Same project in the connections panel and under the sidebar's tag filter.

Folders

Folders can be nested to any depth (up to 16 levels), and the sidebar shows them as a tree: each folder under its parent, indented, with its own notes first and its sub-folders below. Click a folder to collapse it (everything under it hides). With a search active, the notes that match stay with the folders above them. You can:

• Drag notes between folders and the root, and reorder notes and folders (which switches sorting to Custom).
• Drag a folder onto another to move it inside (the middle of the folder; the top and bottom edges reorder next to it), or onto the empty part of the list to bring it to the top level. A folder can never go into itself or into something it holds.
• Each folder has a New folder inside action.
• Double-click a folder header to rename it (it keeps its parent; the notes under it, at any depth, move with it and the links to them follow); each folder has its own "new note here" and delete actions.
• Deleting a folder keeps what is in it: its notes, files and sub-folders move up one level, into the folder above (the top level for a top-level folder). A name that is taken there is not overwritten: the incoming one is renamed (Note (Q4).md). A folder holding a hidden item that is not just system litter (a .git folder, say) is refused before anything moves.
• Pin a note (star) to keep it at the top.
• Cycle the sort order between Date, Name, Size, and Custom.

Sidebar rows are two lines: the title with a relative timestamp, and a short preview of the body.

Daily notes

Open today's daily note from the sidebar's calendar action, the empty-state button, Quick Open, or the File menu. The file is named YYYY-MM-DD.md. If it already exists it opens; otherwise Noted creates it with a localized long-form date heading and three sections: Notes, To-do, and Ideas.

Templates

Noted ships five built-in templates, each localized: Meeting, Project, Research, Journal, and Brainstorm. Open the template picker from the title bar or Quick Open to start a new note from one.

You can also save the current note as a custom template and reuse or delete it later.

Version history

Every save can snapshot the note. Open History from the title bar to browse previous versions and Restore one. Snapshots are stored per note (in a .noted_history folder inside your vault), captured when the content changed enough or enough time passed, and capped at the 20 most recent per note.

Note advisor

A small badge in the title bar surfaces suggestions about the current note, such as:

• a possible secret in the text (API tokens, keys, credentials),
• a generic title worth renaming,
• a long note that might be worth splitting, or one without headings,
• a stale note untouched for a long time,
• a duplicate topic shared with other notes, with an option to merge them.

Each suggestion comes with a one-click action. Merging concatenates the notes and removes the sources, so treat it as a deliberate action.

Next steps

• Search — find anything across the vault.

Opening an Obsidian vault

Point Noted at an Obsidian vault with Settings → Sync → Choose custom folder and it is used where it is: no copy, no conversion, and nothing in it is rewritten just because you opened it. A note is written only when you edit it, and then only that note.

• A folder with a .obsidian/ folder is read as Markdown. .obsidian/, .trash/ and every other dot-folder are ignored.
• Links follow Obsidian's rules. Case does not matter; [[Plan]] finds Work/Plan.md wherever it sits; [[Work/Plan]] means that note; when two notes share a name the one next to the note holding the link wins, then the shortest path. Backlinks, following a link and renaming all use the same rule, and renaming a note rewrites only the links that would no longer find it.
• Images go to the folder named in Obsidian's Default location for new attachments when that is one folder at the vault's root. Other choices (next to the note, a subfolder of it) are not supported, and Noted's own Images folder setting applies.
• File names stay yours. Title follows filename does not rename notes in an Obsidian vault.
• A note's formatting is kept as you wrote it until you edit that note; saving it then writes it the way Noted does (see Note format). Frontmatter is never reformatted.
• Noted keeps what it needs (a note's earlier versions) in hidden folders inside the vault; Obsidian ignores them.

Folders of an Obsidian vault keep their structure when you import them (a tree too deep to keep is flattened into one folder named after its path), and .obsidian/, .trash/ and every other hidden folder are ignored.

Properties

The YAML block at the top of a Markdown note holds its properties (status: open, due: 2026-10-09, tags: [a, b]). The Properties tab of the right panel shows those of the open note, each in the editor for its type: text, number, date, checkbox, list, or link (parent: "[[Home]]"). Edit one and only that property changes in the file: its comments, quoting, order and spacing, and the rest of the note, stay as they were. Add property takes a name (the names the vault already uses are suggested) and a type; to remove one, use the x beside it.

A link property shows as the note's name and opens it with a click. It counts as a link like one in the text: the note appears in the linked note's backlinks, and renaming or moving the linked note updates the property too. (This is for Markdown vaults; in an older HTML vault the properties are kept in a comment that links do not reach.)

The same properties, for many notes at once, are what Views show as tables and boards.