Note Refactor Plus
aonosota144 downloadsExtract selections or headings into new notes using multiple configurable profiles (template, folder, filename rule, link style).
- Overview
- Scorecard
- Updates4
English | 日本語
Note Refactor Plus
Extract selected text or entire heading sections into new notes — using configurable profiles that control filename rules, destination folders, template files, frontmatter, and more.
Features
- Selection extraction — extract highlighted text into a new note
- Heading extraction — extract the section under the cursor's heading
- Bulk split by heading level — split an entire note at every H1, H2, or H3
- Split from cursor — move everything from the cursor position to the end of the note into a new note
- Multiple profiles — each profile is a preset combining all extraction settings; switch between them per operation
- Command palette and hotkeys — a command is registered for each profile so you can assign hotkeys
- Editor context menu — right-click to extract with a profile directly from the editor
- Undo last extract — one-step undo that restores the source note and deletes the created file
- Templater integration — optionally run Templater on the new note right after creation
- Note Refactor import — import your existing Note Refactor settings as a starting profile
- Bilingual UI — English and Japanese (follows Obsidian's locale setting)
Requirements
- Obsidian 1.11.0 or later
- Desktop and mobile supported
Getting started
- Install the plugin through the Obsidian community plugin browser (or copy the release files into
.obsidian/plugins/note-refactor-plus/). - Enable the plugin in Settings → Community plugins.
- Open Settings → Note Refactor Plus and configure at least one profile.
- Select some text in a note, open the command palette, and run Extract selection (choose profile…).
Commands
| Command | Description |
|---|---|
| Extract selection (choose profile…) | Opens a profile picker, then extracts the selection |
| Extract selection (default profile) | Extracts the selection using the default profile |
| Extract heading (choose profile…) | Extracts the heading section at the cursor |
| Extract heading (default profile) | Same, using the default profile |
| Split by H1/H2/H3 headings (choose profile…) | Splits the whole note at every heading of the given level |
| Split from cursor (choose profile…) | Moves from the cursor to the end of the note into a new note |
| Split from cursor (default profile) | Same, using the default profile |
| Extract: {profile name} | One command per profile for direct hotkey assignment |
| Undo last extract | Restores the source note and deletes the most recently created file |
Profile settings
Each profile configures the following:
Basic
| Setting | Description |
|---|---|
| Name | Displayed in the command palette and profile picker |
| Icon | Lucide icon name (e.g. scissors, file-text) |
| Description | Optional subtitle shown in the picker |
Extraction
| Setting | Values | Description |
|---|---|---|
| Extract mode | Move / Copy | Move removes the text from the source; Copy keeps it |
| Source replacement | Link / Embed / Nothing / Keep and append link | What replaces the extracted text in the source note |
| Note link template | Template string | Custom replacement for the source note. Overrides Source replacement when set. Variables: {{title}}, {{source_link}}, {{content}}, {{date:YYYYMMDD}} |
| After extract | Open / Open in new pane / Do nothing | What happens to the new note after creation |
| Conflict policy | Append number / Append to existing / Ask | How to handle a filename collision |
Filename
| Setting | Values | Description |
|---|---|---|
| Filename rule | First line / Prompt / Pattern | How the new note's filename is determined |
| Pattern | Template string | Used when rule is Pattern. Variables: {{title}}, {{date:YYYYMMDD}}, {{time:HHmm}} |
Content transforms
| Setting | Description |
|---|---|
| Exclude first line | Removes the first line from the extracted content. Useful with the First line filename rule to avoid duplicating the title. |
| Include first line as heading | Prepends the original first line as a Markdown heading (H1, H2, or H3) in the new note. Best combined with Exclude first line. |
| Normalize heading levels | Promotes all heading levels in the extracted content so the shallowest heading becomes H1. |
Destination folder
| Setting | Values | Description |
|---|---|---|
| Destination | Same as source / Fixed folder | Where the new note is saved |
| Folder path | Vault-relative path | Used when Destination is Fixed folder. Empty = vault root. |
Target
| Setting | Values | Description |
|---|---|---|
| Target | New note / Append to existing note | Create a new file or append to one that already exists |
| Target file | Vault-relative path | The file to append to. Empty = prompt at runtime. |
| Append position | End of file / Under heading | Where in the target file the content is appended |
| Heading name | Exact heading text | Required when Append position is Under heading |
Template & frontmatter
| Setting | Description |
|---|---|
| Template file | Path to a .md file used as the body template for the new note. Leave empty for plain content extraction. |
| Run Templater after creation | Passes the new note through the Templater plugin immediately after creation. Requires Templater to be installed and enabled. |
To add frontmatter properties (tags, source reference, custom keys) to extracted notes, include a YAML front matter block in your template file.
Template variables
The following variables can be used in template files and Note link template:
| Variable | Description |
|---|---|
{{content}} |
The extracted text |
{{title}} / {{new_note_title}} |
The new note's filename (without extension) |
{{source_link}} |
A Markdown link to the source note (respects vault link format) |
{{source_title}} |
The source note's filename without extension |
{{source_path}} |
The source note's full vault-relative path |
{{heading}} |
The nearest heading above the cursor (for selection extractions) |
{{date:FORMAT}} |
Current date. FORMAT uses YYYY, MM, DD tokens. Example: {{date:YYYYMMDD}} |
{{time:FORMAT}} |
Current time. FORMAT uses HH, mm, ss tokens. Example: {{time:HHmm}} |
Context menu
When Show context menu is enabled in global settings, right-clicking in the editor shows extract options directly. The top N most-used profiles appear as direct items; if you have more profiles than N, a "choose profile…" item appears at the bottom.
The Context menu items slider controls N (default: 3).
Importing from Note Refactor
If you were using the Note Refactor plugin, you can import its settings as a starting profile:
- Make sure Note Refactor is installed (it does not need to be enabled).
- Open Settings → Note Refactor Plus → Compatibility.
- Click Import.
The importer reads Note Refactor's data.json and creates a new profile with equivalent settings. If Note Refactor had an inline note template (not a template file), the content is shown in a notice so you can create a .md file and assign it as the Template file in the new profile.
CSS classes
All CSS classes used by this plugin are prefixed with nrp-. You can override them with a CSS snippet.
| Class | Element |
|---|---|
.nrp-profile-list |
Container for the profile list in settings |
.nrp-profile-item |
Individual profile row |
.nrp-profile-item.nrp-dragging |
Profile row being dragged |
.nrp-profile-item.nrp-drag-over |
Profile row that is the drop target |
.nrp-drag-handle |
Drag handle icon on the left of each profile row |
.nrp-profile-icon |
Profile icon |
.nrp-profile-info |
Name + description container |
.nrp-profile-name |
Profile name text |
.nrp-profile-desc |
Profile description text |
.nrp-default-badge |
"default" badge shown on the default profile |
.nrp-reorder-btns |
Up/down button container |
.nrp-profile-actions |
Action buttons container (set default, edit, duplicate, delete) |
.nrp-btn-default-active |
"Default" button when the profile is already default |
.nrp-profile-editor-modal |
Profile editor modal |
.nrp-section-heading |
Section headings inside the profile editor |
.nrp-icon-preview |
Live icon preview next to the icon name input |
.nrp-setting-group |
Indented group of related settings (e.g. append-to-existing details) |
.nrp-editor-actions |
Bottom action bar (Preview / Cancel / Save) |
.nrp-preview-modal |
Template preview modal |
.nrp-preview-label |
Section label inside the preview modal |
.nrp-preview-filename |
Filename preview block |
.nrp-preview-body |
Note body preview block |
License
MIT
HealthExcellent
ReviewPassed
About
Extract selected text or entire heading sections into new notes using configurable profiles for filename rules, destination folders, templates, and frontmatter. Split notes by heading level or from the cursor, run Templater on new files, undo the last extract, and trigger operations from the command palette, hotkeys, or editor context menu.Details
Current version
0.1.3
Last updated
Last week
Created
2 weeks ago
Updates
4 releases
Downloads
144
Compatible with
Obsidian 1.13.1+
Platforms
Desktop, Mobile
License
MIT