Text Case and Cleanup

Text Case and Cleanup

Change the case of the text you have selected, and clean up prose that came out of a PDF, a scan or a web page.

Everything runs on the text in front of you. There is no network access, no telemetry and no paste hook: a command only ever touches the selection you give it, and each one is a single undo step.

Installing

In Obsidian, open Settings -> Community plugins -> Browse, search for Text Case and Cleanup, then install and enable it.

To install it by hand instead:

1. Download main.js, manifest.json and styles.css from the latest release.
2. Put the three files in <your vault>/.obsidian/plugins/text-format/.
3. Reload Obsidian and turn the plugin on under Settings -> Community plugins.

It needs Obsidian 1.0.0 or newer, and works on desktop and mobile alike.

Commands

Each command works on every selection you have. With no selection it works on the current line, and on a blank line it does nothing.

Case

Names: variables, file names, tags, anchors

They read each other as well as prose: userAccountId, user_account_id and USER-ACCOUNT-ID all give the same words, XMLHttpRequest splits as xml_http_request, and don't stays one word. Each line converts on its own and keeps its bullet, task box or heading hashes, so a list of titles becomes a list of slugs, not one long identifier. Links, URLs, inline code and maths are left in place.

One hotkey for all of them

Change case… lists every case with a preview of what your selection would become. Type a few letters to filter (snake, kebab), then Enter.

Sentence case lowers everything first and then raises the opening word of each sentence. Capitalize sentences only raises the opening word, so proper nouns you already typed survive.

Cleanup

Lines

These work on every line the selection touches, or on the whole note when nothing is selected. The front matter is never included, lines inside code blocks are never removed, and one undo puts everything back.

What these commands will not touch

• Fenced code blocks and inline code are copied through untouched, as is inline maths.
• URLs, wikilinks, autolinks and e-mail addresses keep their case, because lowering a URL can break it.
• A line's markdown prefix — quote markers, bullets, ordered numbers, task checkboxes, heading hashes — is never rewritten. - [x] buy milk becomes - [x] Buy milk, never - [X] Buy Milk.
• Abbreviations and decimals (e.g., U.S.A., 3.14) do not end a sentence and keep their own capitals.

Settings

Scope

This is a rebuild of the uncontested half of Text Format, whose last release was in July 2024. It deliberately leaves out:

• Whitespace trimming and format-on-paste. Several maintained plugins already do this, and rewriting the clipboard as it lands is a different and riskier product than a command you invoke.
• The original's grab bag — callouts, Anki, LaTeX conversion, table to list, heading level shifting, API requests. Those are separate tools wearing one name.

Bugs it does not reproduce

These are open issues on the original. They are fixed here by design, and each one has a test naming it.

Building and testing

npm install
npm test     # the logic, under plain Node
npm run build

The logic lives in src/case.ts and src/cleanup.ts and imports nothing from Obsidian, so it runs and is tested under plain Node. main.ts is the only file that talks to the editor, and it edits by range inside one editor.transaction, so a command is one undo step and never replaces the document.

More plugins by Siulved54

All of them are in the community directory: Settings -> Community plugins -> Browse, then search for the name.

Licence

MIT, see LICENSE.