# Smart Fold for Obsidian

Smart Fold is a highly optimized and lightweight Obsidian plugin that provides advanced yet intuitive tools for efficiently folding Markdown sections. It gives you finer control over the built-in folding mechanism in Obsidian without taking over your content.

## Features

**Adaptive Fold/Unfold Shortcuts**: You can add hotkeys to globally increase or decrease the headings' folding depth across the active document.

**Specific Heading Level Toggles**: Easily toggle specific heading levels from H1 to H6 individually. Hotkeys can be set for targeting specific levels directly.

**Smart Fold**: An intelligent command that specifically toggles folding for all headings that **do not have any children (sub-headings)**. Excellent for cleanly summarizing documents where leaf-node contents get too long.

**Auto-Fold on Open**: Highly requested feature—configure the plugin to automatically apply a specific fold state whenever you open a new file. You can choose to automatically fold everything to H1, or apply the Smart Fold!

**Ribbon Quick Icons**: Provides quick, aesthetic custom SVG icons on the left Ribbon menu `H1`-`H6`, `HS` (Smart Fold), `H+` (Increase Fold), and `H-` (Decrease Fold). 

**Unified Toggle Logic**: Turning off a ribbon icon in the plugin's settings will **automatically disable its corresponding command and hotkey**. This keeps your command palette and hotkey list clean and focused only on the 9 core features you use.

## Usage & Settings

1. Enable the plugin under Community Plugins.
2. Under **Settings -> Smart Fold**, you can choose which Ribbon Icons you want visible.
3. You can set the **Default Fold State on Open** from the same panel.
4. Go to Obsidian's native **Settings -> Hotkeys** and search for `Smart Fold` to assign customized shortcuts.

## Development

The project requires **Node.js >= 24.11.1**. You can install dependencies and build it using:

```bash
npm install
npm run build
```

## Credits

- **Inspiration**: This plugin's core folding logic directly references and is inspired by the exceptional work done in [obsidian-creases](https://github.com/liamcain/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**: The development, refactoring, and refinement of this plugin were assisted by **Antigravity**, an advanced agentic AI coding assistant developed by Google Deepmind.