README file from
GithubSave History
Obsidian plugin for saving and restoring markdown file versions.
Features
- Manual version saving — save the current state of a file at any time
- Version restore — restore any previously saved version with one click
- Pre-restore backup — before restoring, the current state is automatically saved as a backup
- Diff comparison — compare any two versions or a version with the current file
- Preview modal — preview a version before restoring (draggable and resizable)
- Version grouping — group versions by day, week, month, or year
- Rename labels — give custom names to saved versions
- Multi-language — English and Russian interface
- Customizable snapshot folder — change where versions are stored
- Delete with confirmation — safe deletion with confirmation prompt
Installation
From GitHub Releases
- Download the latest release zip from Releases
- Extract
main.jsandmanifest.jsoninto your vault's.obsidian/plugins/save history/folder - Enable the plugin in Obsidian settings → Community plugins
Manual
- Clone this repository
- Run
npm install - Run
npm run build - Copy
main.jsandmanifest.jsonto your vault's.obsidian/plugins/save history/folder
Usage
- Open a markdown file in Obsidian
- Use the sidebar panel "File History" to view and manage versions
- Or use commands from the command palette:
- Save version now — save the current state
- Restore version — open the restore modal
- Open history sidebar — open the version list panel
- Restore last unsaved version — restore the pre-restore backup
Development
npm install
npm run build
To watch for changes:
npm run watch
License
MIT