Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Split by Heading

siulved54siulved5422 downloads

Split a note into one note per heading, with links back in the source.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates2

Split a note into one note per heading, with links back in the source.

A note split into three notes, with links where the sections were

Usage

Two commands, both in the command palette:

  • Split note by headings (pick level): choose a heading level (the picker shows how many notes each level makes) and every heading of that level becomes its own note. Deeper headings stay inside their note.
  • Split note here (heading above): splits only the section under the nearest heading above the cursor.
  • Merge linked notes back into this note: the reverse. Every line that holds only a link or embed of another note is replaced by that note's text under a heading named after the note, one level below the heading above it (level 2 when there is none). Select some lines to merge only those. The merged notes are kept unless you turn on "Trash notes after merging them back". One Undo restores the links.

Each new note is named after its heading (characters Obsidian rejects are removed; a taken name gets " 2", " 3"), holds the text under the heading, and sits next to the source note or in the folder you choose. Where a section was, the source gets a link, an embed or nothing, as you choose in the settings. Text before the first heading, front matter and code blocks are left alone.

The source note is changed in one editor step, so Undo brings it back; the new notes stay and can be deleted. If the note changes while the files are being created, nothing is touched.

Links from other notes to a heading or block of the source ([[Note#Heading]], [[Note#^id]]) are not rewritten and will need updating. If you choose a different folder, relative Markdown links inside the moved text ([x](../file.md)) are not rewritten either; wikilinks keep working.

To pull out just a selection, or to merge notes, use Obsidian's core Note composer.

Installation

In Obsidian, open Settings → Community plugins → Browse and search for "Split by Heading".

More plugins by Siulved54

Plugin What it does Source
Shared Blocks Write a block of text once and reuse it in any note. Edit the source and every reference re-renders live. shared-blocks
Text Case and Cleanup Change case, make camelCase or slugs, sort lines and remove duplicates, and repair text pasted out of a PDF, without touching code or URLs. text-format
Typography as You Type Curly quotes, dashes and ellipses as you type, kept out of code and maths, with Backspace to take one back. smart-typography-plugin
Section Numbering Number headings as an outline (1, 1.1, 1.2) and keep every link to them working when they renumber. section-numbering
Spreadsheet to Table Paste cells from Excel or Google Sheets as a Markdown table with a real header, insert CSV files, and copy tables back out. spreadsheet-to-table
Hybrid Line Numbers Relative and hybrid line numbers for Vim-style jumps, where a folded section counts as one line. hybrid-line-numbers
List Item Callouts Colour a single list item as a callout by starting it with a character such as &, ! or ?. list-item-callouts
Folder Counts See how many notes or files each folder holds, right in the file explorer, with a vault total and folder exclusions. folder-counts
Note Reading Time Reading time of the current note or your selection in the status bar, optionally saved to a property. note-reading-time
Task Rollover Roll unfinished tasks from your last daily note into today's when it is created, with a real undo. task-rollover
Zoom Into Section Zoom into a heading or list item to see only it and its contents, with a breadcrumb bar to climb back out. zoom-into-section
Link Title on Paste Paste a web address and get a Markdown link with the page's title, fetched in the background and undone in one step. link-title-on-paste
Update Radar Checks your installed community plugins for updates in the background, shows what changed, and flags the ones that look abandoned. community-update-checker
Dataview to Bases Convert Dataview queries into Bases blocks, and see which queries in your vault can be converted. dataview-to-bases
Line Editing Commands Duplicate, join, sort and reverse lines, insert blank lines and jump to a line number, with multi-cursor support. line-editing-commands
Note Mover Rules Move notes into folders by ordered rules on tags, properties, titles and paths, with a preview before any bulk move. note-mover-rules
Tab History Keeps each tab's back and forward history across restarts, and adds commands to move, maximize and close tabs. tab-history
URL Cards Shows web addresses as cards with title, description and image, and reads existing cardlink blocks. url-cards
Vim Config Loads a vimrc-style file from your vault so your key mappings and editor commands are ready when vim mode starts. vim-config
Task Archive Moves completed tasks, with their sub-items, into an archive section or note. task-archive
Revisit Later Link the current note into a future daily note, with a date typed in plain English, so it comes back when you want to review it. revisit-later
Explorer Colors Plus Color files and folders in the file explorer, with a palette, cascading to children, and import from File Color. explorer-colors-plus
Book Lookup Create book notes from Open Library or Google Books, with cover images, ISBN search and Book Search compatible templates. book-lookup
Web Search Menu Search the web for selected text or the note title from the right-click menu, with engines you define. web-search-menu
Word Lookup Look up any word in a sidebar dictionary with definitions, phonetics, synonyms and antonyms, or create a note for it. word-lookup
Quick Translate Translate the selection or a whole note into another language with no account, keeping links, code and front matter untouched. quick-translate
Dice Rolls Inline dice rolls you click to reroll, in Live Preview and Reading view, with full dice notation, a roll dialog and a roll history. Reads Dice Roller notes. dice-rolls
Claude Studio Notion-style AI writing, chat and vault tools powered by your local Claude Code CLI. claude-studio
Book Studio Turn notes into a print-ready paperback PDF and an EPUB 3, entirely on your device. book-studio
Emoji Search Insert emojis from a searchable picker or by typing a :shortcode. emoji-search
Inline TOC Show a live table of contents inside any note with a toc code block, or insert a plain Markdown one. inline-toc
Run Code Blocks Adds a Run button to code blocks and shows the output right below, for JavaScript, Python, shell and more. run-code-blocks
Canvas Finder Fuzzy-search the cards and files on a canvas and jump straight to the match. canvas-finder
Folder Index Notes Keeps an index note in each folder up to date with links to the notes and subfolders inside it. folder-index-notes
Random Note Filters Open or link a random note from a folder, tag, property or the current search results. random-note-filters

All of them are in the community directory: Settings -> Community plugins -> Browse, then search for the name. Demos and install links for every one: the catalog.

Follow new plugins and updates on X: @luenpereza

HealthExcellent
ReviewPassed
About
Split a note into separate files—one per chosen heading level or for the section under the cursor—and replace each original section with a link, an embed, or leave it in place. Merge linked notes back into the source under new headings while preserving front matter and code blocks; new files are named from headings and Undo restores the original links.
FilesOutliningLinks
Details
Current version
0.2.0
Last updated
4 days ago
Created
4 days ago
Updates
2 releases
Downloads
22
Compatible with
Obsidian 1.6.6+
Platforms
Desktop, Mobile
License
MIT
Report bugRequest featureReport plugin
Author
siulved54siulved54
GitHubperezamadorluisenrique-gif
  1. Community
  2. Plugins
  3. Files
  4. Split by Heading

Related plugins

Advanced URI

Control everything with URI.

Find orphaned files and broken links

Find files that are not linked anywhere and would otherwise be lost in your vault. In other words: files with no backlinks.

Custom Attachment Location

Customize attachment location with variables($filename, $data, etc) like Typora.

Note Refactor

Extract note content into new notes and split notes.

Notebook Navigator

A better file browser and calendar inspired by Apple Notes, Bear, Evernote and Day One.

Excalidraw

Visual PKM powerhouse. Create and edit Excalidraw drawings.

ExcaliBrain

An interactive, structured mind-map of your Obsidian vault.

Claudian

Embeds Claude Code/Codex and other local Agents as AI collaborators in your vault.

Smart Connections

Find related notes and excerpts while writing. Your AI link building copilot displays relevant content in graph + list view. A local embedding model powers semantic search. Zero setup. No API key.

Breadcrumbs

Visualise the hierarchy of your vault using a breadcrumb trail or matrix view.