patruusbarba_ObsidianSpoile.../README.md
root ef2dc0aef2 Bump version to 0.2.2
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-15 23:39:23 +00:00

62 lines
1.8 KiB
Markdown

# Obsidian Spoiler Plugin
An [Obsidian](https://obsidian.md) plugin that lets you hide and reveal sensitive
text in your notes with a single click. Select some text, press the ribbon
button, and the selection is wrapped in a collapsible **spoiler** callout. Press
it again on a spoiler and it gets unwrapped back to plain text.
![Demo of the spoiler plugin toggling a selection in Obsidian](Demo.gif)
## Features
- Adds a button to the left ribbon (near *Open daily note*).
- Wraps the currently selected text in a collapsible spoiler callout.
- Toggling: if the selection already is a spoiler, it is unwrapped back to plain
text.
## Spoiler format
The plugin wraps your selection in a collapsible `spoiler` callout, preserving
any markdown inside it:
```markdown
> [!spoiler]-
> super_secret_key
```
In reading view this renders as a collapsed callout; click it to reveal the
contents.
## Usage
1. Open a note and select the text you want to hide.
2. Click the spoiler button in the left ribbon.
3. The selected text is replaced with a spoiler callout.
4. To reveal it permanently, select the spoiler and click the button again to
unwrap it.
## Installation
### From a release (recommended)
1. Download `main.js` and `manifest.json` from the
[latest release](https://github.com/PatruusBarba/ObsidianSpoilerPlugin/releases/latest).
2. Put both files in your vault at
`<vault>/.obsidian/plugins/spoiler/`.
3. Reload Obsidian and enable **Spoiler** in *Settings → Community plugins*
(you may need to turn off *Restricted mode* first).
### Building from source
```bash
npm install
npm run build
```
This produces `main.js`. Copy it together with `manifest.json` into
`<vault>/.obsidian/plugins/spoiler/`, then reload Obsidian and
enable the plugin as above.
## License
MIT