Creates a note.
The File Path can contain folders; these folders will be created if necessary. For instance, my/new/notes/Hello
will create the note Hello.md
in my/new/notes/
. If the folder structure my/new/notes/
didn’t exist, it will exist when the action is finished.
The action will append .md
to the note filename if necessary, as mentioned in the example above.
The note can be created empty, or you can pass a note body. It’s also possible to apply a template (either using the community plugin Templater or the core plugin Templates). Passing a note body and applying a template are mutually exclusive. Passing a note body or applying a specific template will cause Obsidian to ignore any existing “Folder Templates” rules in Templater that may have been set for that folder.
The default behavior in case there’s already a note with the same name / at the requested file path, the base file name will be suffixed with a number. You can also choose to overwrite the note or skip the creation of a new, suffixed note (i.e., leaving it as it is).
Parameters
Vault
The vault to work in.
Type: Vault reference
File Path
The path of the note, relative to the vault root.
Type: Text
Optional Note Body
The text body of your new note.
The use of this parameter depends on your After creating the note … selection. Passing a note body or applying a specific template will cause Obsidian to ignore any template you may have set for its Daily Note core plugin or Periodic Notes community plugin, so if you want to see your usual template applied, leave Note Body empty.
Type: Text
Optional Template Path
The full path of a Templates or Templater template, relative from the vault root.
The use of this parameter depends on your After creating the note … selection. Passing a note body or applying a specific template will cause Obsidian to ignore any template you may have set for its Daily Note core plugin or Periodic Notes community plugin, so if you want to see your usual template applied, leave Note Body empty.
Type: Text
After creating the note …
What should be done after the file has been created?
Options:
- insert note body
- apply Templates (core plugin)
- apply Templater
Strategy for dealing with an existing note
The default behavior in case there’s already a note with the same name / at the requested file path, the base file name will be suffixed with a number. You can also choose to overwrite the note or skip the creation of a new, suffixed note (i.e., leaving it as it is).
Options:
- Create note with suffix
- Overwrite
- Leave note as-is
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
Related Links
- Search the Actions for Obsidian community forum for "Create Note"