Skip to content

Split a note into individual notes based on a delimiter

License

Notifications You must be signed in to change notification settings

decaf-dev/obsidian-note-splitter

Repository files navigation

Obsidian Note Splitter

Obsidian Downloads

Note splitter is an Obsidian.md plugin for desktop only. It allows you to split a single note into many notes based on a sequence of characters (a delimiter).

Table of contents

Videos

Split a note using default settings.

Screen.Recording.2024-06-27.at.9.57.24.PM.mov

Split a note with use first line as title enabled.

Screen.Recording.2024-06-27.at.9.58.29.PM.mov

Installation

  1. In Obsidian, open Settings
  2. Go to Community plugins
  3. Select Browse
  4. Search for Note Splitter by DecafDev
  5. Select Install
  6. Then select Enable

Usage

  1. Open a note that you want to split
  2. Switch to editing mode
  3. Open the Obsidian command palette
  4. Type Split by delimiter
  5. Press enter
  6. See split notes in the output folder

Note

Splitting a note will not modify the original note.

Frontmatter

When splitting a note, frontmater is ignored. Only content after the frontmatter block is split.

Settings

Output folder

The folder to save split notes in. If the input is empty, the folder of the original note will be used.

Note

Default value is note-splitter

Delimiter

The sequence of characters to split by. When you split a note, the content before and after each delimiter will become new notes.

Note

The default value is a newline character \n

Remove delimiter

If enabled, the delimiter will not be included in the content of split notes.

For example, suppose you have two sentences and your delimiter is set to a period ..

This is sentence 1. This is sentence 2.

If this setting is enabled, the output will be:

This is sentence 1
This is sentence 2

If you wanted to retain the period in each split note, you could disable this setting. The output would then be:

This is sentence 1.
This is sentence 2.

Note

Enabled by default.

Use first line as title

If enabled, the first line of split content will be used as the title of the split note. If the title already exists, the conflict will be indicated by naming the note as Split conflict <random-uuid>.

If disabled, a timestamp will be used as the title e.g. note-splitter-1702591910.

Note

Disabled by default.

Removed characters

Depending on your operating system, Obsidian will not allow certain characters in a file name.

When Use first line as title is enabled, invalid characters in the first line will be removed.

Character Removed On
* Windows
" Windows
` Windows
? Windows
< Windows
> Windows
: Windows, macOS, Linux
\ Windows, macOS, Linux
/ Windows, macOS, Linux
^ Windows, macOS, Linux
[ Windows, macOS, Linux
] Windows, macOS, Linux
# Windows, macOS, Linux

Append to split content

This is text that should appended to the content of each split note.

Delete original

If enabled, the original note will be deleted after a successful split.

Note

Disabled by default.

Learn more

Steps to create Anki flashcards from an English article, using Yanki, ChatGPT, Note Splitter by @jdevtw

Contributing

Issues and pull requests are welcome.

License

Note Splitter is distributed under MIT License