# Capitaliser

![Banner](./media/capitaliser.png)

Effortlessly cycle the capitalisation of your text in Obsidian - just like what Shift+F3 does in Microsoft Word.

Instantly switch between lowercase, Capitalise Each Word, and UPPERCASE with a single command and your favourite hotkey.

---

## ✨ Features

- **Cycle capitalisation**: Transform selected text or the current word between lowercase, Capitalise Each Word, and UPPERCASE.
- **Smart selection**: Works with selections, single words, or entire lines.
- **No setup required**: Assign any hotkey you like in Obsidian’s settings.
- **Fast & lightweight**: No dependencies, instant results.

---

## 🚀 Getting Started

1. Install **Capitaliser** from the Community Plugins browser in Obsidian.
2. Enable the plugin in Obsidian’s settings.
3. Assign your favourite hotkey to the “Cycle text capitalisation” command.

---

## 💡 Usage

**Before using the plugin:**

1. Go to Settings - Hotkeys
2. Search for "Capitaliser: Cycle text capitalisation".
3. Assign your preferred hotkey (e.g., Shift+F3 to match Microsoft Word).

**To use the plugin:**

1. Select text, place your cursor in a word, or select an entire line.
2. Trigger the command (via hotkey).
3. Watch your text cycle through lowercase, Capitalise Each Word, and UPPERCASE.

---

## ☕ Support & Contributions

<a href="https://ko-fi.com/hardpath" target="_blank">
	<img src="./media/support_me_on_kofi_blue.png" alt="Support me on Ko-fi"/>
</a>

If you find this plugin helpful, consider [buying me a coffee](https://ko-fi.com/hardpath) to support future development!