Creases 👕

Tools for efficiently folding markdown sections in Obsidian.

What is a crease?

A crease is a comment inside your Markdown that indicates you want a fold there. Think of it like a crease in a piece of paper, its much easier to fold along the creases!

%% fold %%

Basic usage

The plugin adds several commands to add and use creases in your files:

• Toggle crease: Add or remove a fold marker to the closest foldable line. This could be a heading or a list.
• Fold along creases – Fold all the creased sections of your file.
• Iron out the creases – Remove all the creases from the current file.
• Crease the current folds – Applies a crease to the current folds in the file, allowing you to easily get back to these current folds using fold along creases.

Fold levels (Advanced)

Creases also borrows the concept of a "fold level" from vim. The fold level is inferred from the current folds in the note. If have you have your ## Heading Level 2 headings folded, decreasing the fold level will unfold all headings up to # Heading Level 1. Increasing the fold level will unfold up to your ### Heading Level 3.

• Increase heading fold level - Increase the fold level by 1.
• Decrease heading fold level - Decrease the fold level by 1.

➕ Additional Features

• Templates support – If you use the Templates core plugin, any creases included in your template will automatically be folded.
• Templater support – Add creases to your Templater templates to have content automatically folded.

⚡️ Example Workflows (aka "Has this ever happened to you?")

Create a "save state" for your folds

If you're working on a long document, you might find yourself folding sections as you go. Now you want to do a "Find" in the fold. Uh oh, it found a match but now all your folded away content is unfolded.

Instead, save your folds as creases:

1. Run "Crease the current folds" to mark all your current folds as creased.
2. Search the document to your heart's content, unfolding without a care in the world.
3. Run "Fold along creases" to restore all your folds to exactly how they were before.
4. Optional Now that you're back to your ideal document origami, you can run "Iron out the creases" to get rid of the fold markers.

You want content in your template to be folded by default.

Whether you use the core Templates plugin or Templater, you might find yourself wishing that some sections start folded since you don't look at them often.

1. In your template file, just make sure that %% fold %% appears on the same line as the heading or list item that you want folded. You can also run the "Toggle crease" command from within the template to insert the crease automatically.

You want to fold all the ### Level 3 Headings in your document

Folding all the headings at a given depth can be a tedious process. Well, no longer.

1. Just run "Toggle fold for H3."

🎞 Credits

Special thanks @mleo2003 on Discord for the plugin name.