Skip to content
ActionsDotWork logo ActionsDotWork. Docs
Actions for Obsidian icon Home › Actions for Obsidian 2024.2.3 › Actions

Actions for Obsidian › Actions › Get Note

Returns a specific note.

The note is returned as Note, which gives you access to the entire contents of the note file, as well as just its body, frontmatter, and file path.

This action will throw an error if the specified note doesn't exist, so it's best to use it after the "Check For Existence Of Note" action has determined that it does exist.

Parameters

Vault

The vault to work in.

Type: Vault reference

Note Lookup

Specify which note should be looked up by the action:

  • "note at file path": A specific note at this path. This should be used if you already know the full file path (including folder and file extension).
  • "note with title": A specific note with this title. See In case of duplicates … for fine-tuning.
  • "note with UID": Use this if you are using unique identifiers for your notes, and you prefer to look them up by the UID.
  • the current Periodic Note (today's daily, weekly, etc.)
  • the most recent Periodic Note (either today's or the previous daily, weekly, etc.)

Options:

  • note at file path
  • note with title
  • note with UID
  • current Daily Note
  • current Weekly Note
  • current Monthly Note
  • current Quarterly Note
  • current Yearly Note
  • most recent Daily Note
  • most recent Weekly Note
  • most recent Monthly Note
  • most recent Quarterly Note
  • most recent Yearly Note

File Path

The path of the note, relative to the vault root.

Only available when Note Lookup is set to "note at file path".

Type: Text

UID

The unique identifier of the note. To configure the frontmatter key that is used for the lookup, go into Obsidian's settings, section "Community plugins", and find Actions URI.

Only available when Note Lookup is set to "note with UID".

Type: Text

Title

Enter a note's title.

Only available when Note Lookup is set to "note with title".

Type: Text

In case of duplicates …

When looking up a note by its title, AFO will try to find the note by its given title. If there are several folders containing a note with that title, however, AFO will select the first one after sorting them by a given criterion:

  • "let Obsidian decide": default, is akin to adding the Markdown code [[My Note]] and counting on Obsidian to pick the right file.
  • "select oldest (by creation time)"
  • "select newest (by creation time)"
  • "select oldest (by modification time)"
  • "select newest (by modification time)"
  • "select first by full path": Folder A/My Note would be chosen over Folder B/My Note.
  • "select last by full path"

This option is only available when Note Lookup is set to "note with title".

Options:

  • let Obsidian decide
  • select oldest (by creation time)
  • select newest (by creation time)
  • select oldest (by modification time)
  • select newest (by modification time)
  • select first by full path
  • select last by full path

Open or focus note

If enabled, after a successful operation, the note will be brought to the front in Obsidian.

Type: Boolean (YES/NO)

Return Value

Note reference

  • Search the Actions for Obsidian community forum for "Get Note"