/concatenate

A plugin for Obsidian.md to allow you to put the contents of sections together in one file

Primary LanguageTypeScriptThe UnlicenseUnlicense

Obsidian Concatenate Plugin

Manual Installation

  • Download the latest main.js & mainfest.json from releases.
  • Create a new folder named 'obsidian-concatenate'
  • Place the files in the folder
  • Place the folder in your .obsidian/plugins directory
  • Reload plugins
  • Activate the "Concatenate" plugin

How to use the plugin

  1. Navigate to plugin settings.
  2. Assign a value for which header you want to concatenate the contents of. (i.e. ## Reflections or ### Meeting Logs)
  3. Assign a folder you want to limit the concatenation to (i.e. Calendar/2021/January)
  4. Use the command palette (ctrl+p on windows by default) to Concatenate Headings.
  5. View, rename, and/or move the outputted file, which will be created in your vault’s root directory with a name like “Concatenated_Note-Timestamp.” There will be a popup in the top right hand corner telling you the filename.

Screenshots

image

image

image

Basically, running the Concatenate Headings command from the command palette will take the 6 files on the right (along with all the others in the folder they're in) and output a file that looks like the one on the left. I then cut, paste, re-arrange, re-order, move around, and otherwise sort them into an output that looks like: this reading roundup.

Goals

  • I’d like to add functionality that will let you just search your vault and concatenate all sections / blocks with a particular search result, i.e. letting you concatenate all sections that contain the word cattle instead of needing to assign a particular section name that is always the same.
  • I'd like to add an option to include headings in the concatenated file to indicate which file the section originally came from.

Disclaimer

This is my very first code project of any kind. A few months ago I had never done any programming more complex than simple lua scripts for video games. Please install at your own risk, and understand that updates & bugfixes will be slow and awkward unless someone is willing to submit a pull request.

Credits

Enormous thanks to @pjeby, @mrjackphil, and all the Obsidian.md moderators for their encouragement, support, code tips, refactoring help, handholding with git, and more.