Home

Awesome

Archival Notice

Most of the plugin's features are part of Obsidian Core by now. Therefore, the plugin is archived. Thank you everyone for a total of 20 000 Downloads!


🧠 Smarter Markdown Hotkeys

Obsidian Downloads

A plugin for Obsidian providing hotkeys that select words and lines in a smart way1 before applying markup. Multiple cursors are supported as well.

Demo Video

Table of Contents

<!-- MarkdownTOC --> <!-- /MarkdownTOC -->

Markup Commands with Smart Expansion

All commands also support multiple cursors, smart inclusion/exclusion of special characters, and undoing markup by triggering the same hotkey.

<small>* These commands wrap whole blocks instead of wrapping each line when the hotkey is triggered on a multi-line selection. They also switch to the appropriate syntax, for example from inline code syntax to fenced code syntax. (See below for details.)</small>

Command-Specific Details

The following commands have some special features:

Smarter Markdown/Image Link

Smarter Inline/Fenced Code

Smarter Comment

Smarter Wikilink

Smarter Mathjax

Smarter Callout Label

Turns the text under the cursor into a callout label.

<details> <summary>Demo</summary> <img width=60% alt="Demo Smarter Callout Label Command" src="demo/smarter-callout-label.gif"> </details>

Non-Markup Commands with Smart Expansion Logic

Smarter Punctuation Commands

While strictly speaking quotation marks and brackets are not a form of markup, I found it quite useful to be able to set them in the same way. Therefore, the following commands have been added as well.

When there is no selection, the the Smarter Punctuation Commands essentially emulate ysiw", ysiw), ysiw], and ysiw} from vim-surround.

Smarter Case Switching

The same logic can also be applied to case switching commands. First, the selection is expanded to whole words. Then, the casing of the whole selection is changed. Instead of having multiple hotkeys for each type of casing, this command smartly switches the case depending on the current state.

This allows you to repeatedly press the hotkey to achieve a certain result, e.g. two times on a lowercase word to make it UPPERCASE.

<small>* Sentence case means that the first letter of the string will be capitalized, like in an English sentence. If the string only contains one word, Sentence case produces the same result as Capital Case.</small>

Smarter Delete Text

Deletes text with the same text-expanding logic from the smarter markdown commands. (This command is similar to daw in Vim.)

Commands without Smart Expansion

These commands have simply been added for convenience. They do not use any kind of selection expansion, but are still attempts to improve the normal commands they correspond to.

Smarter Toggle Heading

Increases the Heading Level of the line under the cursor by 1. If already at 6, removes the heading instead. Intended for pressing it quickly multiple times, e.g. pressing the hotkey 3 times to turn a normal line into a h3.

<img width=60% alt="Demo Smarter Toggle Heading Command" src="demo/smarter-toggle-heading.gif">

Smarter Insert New Line

Inserts line break, even when the cursor is in a nested list. Pressing return in a nested list normally inserts a line break followed by a indented list marker. (This command is essentially the same as o in Vim.)

Smarter Delete Current Note (deprecated)

Deletes the current note, but also goes back to the last file instead of leaving an empty pane. (This requires Confirm File Deletion in the Obsidian settings to be disabled.)

Deprecated. With recent versions of Obsidian, deleting a file does not result in empty panes, so this command is now basically obsolete. The command is only left in the plugin to ensure people's hotkeys do not break.

Smarter Copy Path

Press once to copy the vault-relative path of the current file, press a second time to copy the absolute path. Press a third time to copy the (vault-relative) path to the parent folder.

Smarter Copy File Name

Press once to copy the name of the current file without extension, press a second time to copy it with extension.

Toggle Readable Line Length & Toggle Line Numbers

These do pretty much what the name says.

How the Smart Expansion works in detail

Inline code signifies the part of the text being selected. | is a cursor without selection. This table serves as a reference for the precise mechanics of this plugin.

Normal HotkeysSmarter Hotkeys
foo|barfoo****bar**foobar**
foobarf**oo**bar**foobar**
Lorem IpsumLor**em Ips**um**Lorem Ipsum**
- [ ] foobar ^123**- [ ] foobar ^123**- [ ] **foobar** <sup>^123</sup>
## Lorem Ipsum==## Lorem Ipsum==## ==Lorem Ipsum==
- Lorem<br>- Ipsum- Lor**em<br>    - Ips**um- **Lorem**<br>    - **Ipsum**
**foo|bar** (Undo)**foo****bar**foobar
**Lorem Ipsum** (Undo)**Lor**em Ips**um**Lorem Ipsum

You can take a look which characters exactly are included or excluded by taking a look at the const.ts.

Setting the Hotkeys

If you want to replace the default commands from Obsidian, remember to remove their hotkey binding before changing the hotkeys from this plugin. Example for Smarter Bold:

  1. Remove the hotkey cmd/ctrl + B4 for the default command Toggle Bold.
  2. Assign cmd/ctrl + B as the hotkey for the command Smarter Bold.

💡 For the Smarter Punctuation Commands, you can also use a hotkey with shift, e.g. shift + 2 for Smarter Quotation Marks. Curiously, Obsidian accepts such hotkeys, so you can basically "overwrite" normal punctuation typing if you want to.

However, note that this comes at the cost of losing the ability to type punctuation normally. Also, this does seem to result in minor bugs, e.g. interference with Obsidian's in-document search.

Installation

The plugin is available in Obsidian's Community Plugin Browser via: SettingsCommunity PluginsBrowse → Search for "Smarter Markdown Hotkeys"

Contribute

The easiest way to make contributions is to make changes to const.st, since the constants there determine commands and what to include/exclude.

Please use the .eslintrc configuration located in the repository and run eslint before doing a pull request, and do not use prettier. 🙂

# Run eslint fixing most common mistakes
eslint --fix *.ts

About the Developer

In my day job, I am a sociologist studying the social mechanisms underlying the digital economy. For my PhD project, I investigate the governance of the app economy and how software ecosystems manage the tension between innovation and compatibility. If you are interested in this subject, feel free to get in touch!

<!-- markdown-link-check-disable -->

Profiles

Donate

<a href='https://ko-fi.com/Y8Y86SQ91' target='_blank'><img height='36' style='border:0px;height:36px;' src='https://cdn.ko-fi.com/cdn/kofi1.png?v=3' border='0' alt='Buy Me a Coffee at ko-fi.com' /></a>

If you feel very generous, you may also buy me something from my Amazon wish list. But please donate something to developers who still go to college, before you consider buying me an item from my wish list! 😊

Amazon wish list

<!-- markdown-link-check-enable -->

Credits

Thanks to @SkepticMystic for his support during development.

⬆️ Go Back to Top

Footnotes

  1. When there is no selection, the smart expansion is essentially equivalent to ysiw{markup} from vim-surround, but with less keystrokes.

  2. These commands are mostly used for Multi-Color Highlights that some Obsidian themes like Sanctum or Shimmering Focus offer. 2

  3. The supported image extensions are listed here.

  4. macOS uses cmd, Windows and Linux use ctrl.