Obsidian Stats logoObsidian Stats

Smart Fold

by shenfan19
5
4
3
2
1
Score: 52/100
Install Code

Description

Toggle foldings in a smart way

Reviews

  • Tigana
    Reviewed on Jun 16th, 2026
    No review text provided.

Stats

2
stars
457
downloads
0
forks
145
days
1
days
7
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
35
commits

Latest Version

0.1.2
7 days ago

Changelog

Changed

  • Only the Smart Fold and H1 to H3 ribbon icons are enabled by default. H4 to H6 and the increase and decrease fold level icons, together with their commands, can be turned on in the settings. Settings you have already saved are kept.
  • Production builds are written to the repository root.

Fixed

  • The fold state applied when a note opens now uses activeWindow.setTimeout(), so it also works in popout windows.
  • Removed the dotenv and builtin-modules build dependencies in favor of Node's built-in equivalents, and updated development dependencies with known vulnerabilities.
See all version on GitHub

README file from

Github

Smart Fold

Obsidian plugin Downloads Latest release Minimum Obsidian version License

Smart Fold is a plugin for Obsidian that turns a long Markdown note into a readable outline with one click.

HS folds every section that has no subheadings, so the paragraphs disappear and the outline stays. Click again to bring everything back.

Smart Fold folding every section that has no subheadings, then unfolding them again

H1, H2 and H3 fold all headings of one level at once.

Folding all H3 sections, then all H2 sections, then the H1 heading, and opening each again

H- and H+ fold and unfold one level at a time.

Folding one heading level at a time with H-, then opening them again with H+

Features

  • HS, Smart Fold: folds every heading that has no subheading under it, which are the sections holding the actual text. Parent headings stay open, folds you made by hand are kept, and a second click unfolds the same sections.
  • H1 to H6: each toggles all headings of that level. If the first one is folded, all of them unfold, otherwise all of them fold.
  • H- and H+: H- folds the deepest level that is still open, and H+ opens the shallowest folded level together with every level above it.
  • Fold on open: under Settings → Smart Fold → Default fold state on open, notes can open in Smart Fold or folded to a chosen heading level.
  • Native folding: Smart Fold uses the same folds as the arrows next to your headings. Nothing is written into your notes, and any single section opens again with its arrow.

Every action is a ribbon icon and a command, so you can click it or give it a hotkey under Settings → Hotkeys. HS and H1 to H3 are on by default. The other icons can be turned on under Settings → Smart Fold, and turning an icon off also removes its command and hotkey.

Smart Fold settings tab

Installation

Search for Smart Fold under Settings → Community plugins → Browse, then install and enable it. To install manually, copy main.js and manifest.json from the latest release into <your-vault>/.obsidian/plugins/smart-fold/.

Feedback

Found a bug or have an idea? Please open an issue on GitHub. For a bug, include your Obsidian version and a short note that shows the problem.

Development

The project requires Node.js 24.11.1 or later. npm install and npm run build write main.js and manifest.json to dist/. Releases are built and published by GitHub Actions from a version tag, and the steps are described at the top of .github/workflows/release.yml.

Credits

  • Inspiration: This plugin's core folding logic directly references and is inspired by the exceptional work done in obsidian-creases by Liam Cain. His project is licensed under the MIT License, and I retain the spirit of open-source sharing by also releasing this plugin under MIT.
  • AI Assistance: This project was developed with AI coding assistance for code generation, automated testing, and documentation.
Sponsors