Actions for Obsidian › Actions › Append Note

Appends text to a note, either to the very end of the note (default) or to the section below a particular headline in a note.

Parameters

Vault

The vault to work in.

Type: Vault reference

Note Lookup

Specify which note should be looked up or manipulated by the action:

• "note": If you want to use another AFO action’s Note result, pick this option.
• "note at file path": The full path of the note, should be used if you already know the full file path (including folder and file extension).
• "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 (daily, weekly, etc.)

Info

To work with Daily Notes, either the core Daily Notes plugin needs to be active, or the community plugin, Periodic Notes, must have its Daily Note feature enabled. Working with Weekly, Monthly, Quarterly or Yearly Notes requires the community plugin Periodic Notes.

Options:

• note
• note at file path
• note with UID
• Daily Note
• Weekly Note
• Monthly Note
• Quarterly Note
• 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

Obsidian Note

A Note that was returned by another AFO action.

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

Type: Note reference

Text

The text to append to the note.

Type: Text

Headline

The headline must be entered exactly as it appears in the note: headline levels, capitalization, punctuation etc. For example, ## My Headline, ### My Headline, and ## my headline are not identical.

Only applicable when "Append below headline" mode is enabled.

Type: Text

Placement

Where to append the text.

Options:

• end of the note
• end of the section below the headline

Ensure newline

If enabled, a line break will be added to the inserted text if it does not already have one. Useful if you have a piece of text that does not have a line break at the end, but should.

Type: Boolean (YES/NO)

If headline is missing

When adding text below a headline, and the requested headline is missing, what should happen?

Only available when Placement is set to "end of the section below the headline".

Options:

• Show error
• Add headline
• Do nothing

Create note if necessary

If the note couldn't be found and this option is enabled, a new note will be created so text can be appended; if the option is disabled, the action will return an error.

Type: Boolean (YES/NO)

Open or focus note

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

Type: Boolean (YES/NO)

Related Links

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