Renaming, moving, and parking

Renaming notes and headings

• Renaming a note in the Explorer rewrites every [[link]] to its old title. When the links are in more than one note, VS Code asks first, with Show Preview to see each change, as Deckard asks of every write that reaches several notes. One Undo takes back the rename and the links. Links through an aliases: name, links to another note with the same name, and links in fenced code are left alone. Moving a note to another folder changes no links.
• A link’s heading, ^marker, and |display text are kept: [[Vendor review#Terms|the terms]] becomes [[Supplier review#Terms|the terms]].
• Deckard: Rename Heading renames the heading the cursor is in and updates links to it: [[Check-in#Vendor review]] elsewhere and [[#Vendor review]] in the same note. Tags on the heading stay. Save the note first.

Extracting headings

Run Deckard: Extract Heading with the cursor in a heading section. Deckard moves the whole section, nested headings included, into a new note and leaves a [[link]] to it. Outside a heading, it offers a picker of every heading. Existing notes are never overwritten. To move a section under a heading of a note you already have, use Move to… on the heading.

Moving lines and tasks

Deckard: Move to… moves what the cursor is on (a task or list item with everything nested under it, or one line of prose), or every line a selection touches, under another heading, into today’s note, or into a new note. On a heading it moves the whole section. It does not move a blank line, front matter, half a code block, or a selection that holds a heading it does not start on. Run it from the lightbulb, the palette, the Tasks view, a Task board card’s menu, or Find.

• The list starts with New note… and Today’s note, then the five headings Add Task and Move to… used last, then every heading. Lines go under the heading’s own lines, above any nested heading.
• A task left behind becomes - [>] Call Ren 📅 2026-09-20 → [[2026-09-25]]; anything else becomes a [[link]] to where it went. A [>] line is not a task.
• If the lines or heading changed before you chose, nothing is written. The move is not previewed: it is the one you chose. Undo, or Deckard: Undo Last Change, puts both notes back, or neither: if either changed since, nothing is put back.

Moving a section

With the cursor on a heading line, or a selection that starts on one, Deckard: Move to… moves the heading and everything under it: its text, lists, tasks, code, and nested headings, up to the next heading at its level or above. The lightbulb on a heading offers it as Move section to….

• The list starts with Mentioned in this section: the hub notes of the section’s tags and people, then the notes its links name, each with its headings and at the end of the note, at most ten places. New note…, Today’s note, and the headings follow, as for lines. The section’s own headings are never offered.
• Under a heading, the section goes at the end of that heading’s section, after a blank line, one level deeper than it: ## Ledger cutover plan moved under ## Plan becomes ### Ledger cutover plan, and its own subheadings move down alike, none deeper than ######.
• At the end of a note, or in today’s note, it goes after a blank line with its levels kept. A new note is named from the heading and holds the section as written, as Extract Heading makes it.
• One line is left where it was: a link to the heading in its new note, [[Ledger migration#Ledger cutover plan]], or [Ledger migration#Ledger cutover plan](Ledger%20migration.md#ledger-cutover-plan) when deckard.links.style is markdown. Links elsewhere to its old place, such as [[2026-11-12#Ledger cutover plan]], are left as they are; the line left behind leads on.
• As for lines, nothing is written if the section changed while you chose, and Undo puts both notes back.

Parking notes

A note, heading, or task is parked when it is in a parked folder or a search for a parked tag finds it. Parked items stay indexed and searchable but leave the lists of things to do.

• Park Note writes tags: [parked] into front matter; Unpark Note removes it. Both are in the palette, the editor tab’s menu, and the Deckard menus in the editor, Explorer, and search cards, with Undo. A value YAML would misread, such as #atlas, is written in quotes. A tags line that ends in a comment (tags: [a] # mine) is left alone, since writing it again would lose the comment; Deckard says so.
• Park Folder… adds a folder to deckard.parked.folders, from the palette or a folder’s Deckard menu in the Explorer.
• Park Tag… adds a tag to deckard.parked.tags, from the palette, a tag’s menu, or the Outline. It parks everything a search for the tag finds, and its sub-tags: project/old parks #project/old/phase-1. A parked tag’s page says Parked with Unpark.

• A task list shows parked tasks only when its search mentions is:parked: set deckard.tasks.viewQuery to is:parked, or search the board for is:open is:parked. is:parked finds everything parked; -is:parked everything else.
• To keep a status such as Someday out of the Tasks view, set deckard.tasks.viewQuery to -status:someday.
• Use deckard.exclude for files that are not notes, such as build output: excluded files are not read or found. It wins when both match.

← Daily notes, reviews, and the calendar · All topics · Themes and Zen mode →