Go to file
Kim Silkebækken afd0e4242a Merge branch 'release/1.3'
* release/1.3:
  Update vim docs
  Update README
  Update default leader key to <Leader><Leader>
  Move most of the code to autoload/
  Add credits
  Fix CSApprox issue
  Add credits
  Add modelines
  Fix jumplist issues
  Match correct column for lines w/ multibyte chars
  Update docs
  Update default highlighting colors
  Update default leader key to avoid plugin conflicts
  Add EasyMotionSearch function and mapping
  Use first word char as the display target for JK motions
  Skip empty mappings
  Temporarily disable spell checking
2011-11-07 14:42:59 +01:00
autoload Move most of the code to autoload/ 2011-11-07 14:33:20 +01:00
doc Update vim docs 2011-11-07 14:42:45 +01:00
plugin Update default leader key to <Leader><Leader> 2011-11-07 14:34:37 +01:00
.gitignore Ignore help tags generated by vim 2011-04-02 17:57:18 +02:00
README.md Update README 2011-11-07 14:39:51 +01:00

Introduction

EasyMotion provides a much simpler way to use some motions in vim. It takes the <number> out of <number>w or <number>f{char} by highlighting all possible choices and allowing you to press one key to jump directly to the target.

When one of the available motions is triggered, all visible text preceding or following the cursor is faded, and motion targets are highlighted.

EasyMotion is triggered by one of the provided mappings.

Important notes about the default bindings

The default leader has been changed to <Leader><Leader> to avoid conflicts with other plugins you may have installed. This can easily be changed back to pre-1.3 behavior by rebinding the leader in your vimrc:

let g:EasyMotion_leader_key = '<Leader>'

All motions are now triggered with <Leader><Leader> by default, e.g. <Leader><Leader>t, <Leader><Leader>gE.

Usage example

Type <Leader><Leader>w to trigger the word motion w. When the motion is triggered, the text is updated (no braces are actually added, the text is highlighted in red by default):

<cursor>Lorem {a}psum {b}olor {c}it {d}met.

Press c to jump to the beginning of the word "sit":

Lorem ipsum dolor <cursor>sit amet.

Similarly, if you're looking for an "o", you can use the f motion. Type <Leader><Leader>fo, and all "o" characters are highlighted:

<cursor>L{a}rem ipsum d{b}l{c}r sit amet.

Press b to jump to the second "o":

Lorem ipsum d<cursor>olor sit amet.

Jeffrey Way of Nettuts+ has also written a tutorial about EasyMotion.

Animated demonstration

Animated demonstration