ヘルプの起動/終了
Vim/Neovim エディタ内で下記のコマンドを実行することで、ヘルプを起動・終了することができます。
:help… ヘルプを起動する:q/ZZ… ヘルプを終了する
vim/nvim コマンド実行時に + オプションを付けて起動することで、Vim のヘルプを直接開くこともできます。
$ nvim +help # Vim のヘルプを起動して開く
$ nvim +"help :highlight" # highlight コマンドのヘルプを起動して開く
:help コマンドに渡すパラメータ
:help コマンドの引数に特定のプレフィックスを付けたり、引数を引用符で囲むことで、異なるモードのコマンドのヘルプを見ることができます。
| 何のヘルプを読むか | プレフィックスなど | 例 |
|---|---|---|
| exコマンド | : | :help :quit |
| オプション | 'name' | :help 'number' |
| Vim の起動パラメータ | - | :help -t |
| キー入力 (normal mode) | なし | :help u |
| キー入力 (insert mode) | i_ | :help i_CTRL-N, :help i_<Esc> |
| キー入力 (visual mode) | v_ | :help v_u |
| キー入力 (command mode) | c_ | :help c_<Del> |
特殊なキー入力は、CTRL-A、<Del>、<Esc> のように表現することができます(他のキーの表現方法は :help keycodes で確認できます)。
:help CTRL-A:help i_CTRL-A:help -t:help 'number'ヘルプファイルを grep する
:helpgrep コマンドを使用すると、ヘルプファイル内を grep 検索することができます。
:helpgrep keyword
検索が終了すると、最初にキーワードにヒットした部分のヘルプが表示されるのですが、多くの場合は複数個所がヒットしているはずです。
検索後に :copen コマンドを実行すると、ヒットした行の一覧を表示し、そこから各ヒット位置へジャンプすることができます。
一覧表示のウィンドウは :cclose コマンドで閉じることができます。
ヘルプを起動した後の操作方法
:help コマンドでヘルプを起動した後は、下記の操作で項目間をジャンプすることができます。
Ctrl-]…|:help|などのリンク先へジャンプ(タグジャンプ)Ctrl-t… ジャンプ先から戻る
Vim の doc ディレクトリ内に tags ファイルが用意されているので、Ctrl-] を使ってカーソル位置の単語に関連するヘルプページにジャンプすることができます。
GUI 版の gvim を使用している場合は、マウスで単語をダブルクリックしても同様にジャンプできます。
例えば、:help で表示されたページの usr_01.txt にカーソルを合わせて Ctrl-] を入力すると、usr_01.txt のヘルプページへジャンプできます。
ジャンプ元に戻って来たい場合は、Ctrl-t と入力します。