Skip to content
w3m plugin for vim
Find file
New pull request
Latest commit 228a852 @yuratomo #21 fix local href open



w3m.vim is a plugin on vim for w3m that is a console web browser.


w3m.vim requires w3m to be installed.

If w3m is not in your $PATH, you can specify its location in your vimrc file.

let g:w3m#command = 'C:\w3m.exe'


Open URL:

input :W3m [url or keyword]

Search Mode:

input :W3m search-engine-name keyword

alc              : space alc
android          : Android SDK
as3              : ActionScript 3.0
go               : Go language
google           : Google
java             : JDK6
man              : man
msdn             : MSDN
perl             : PERL
php              : PHP
python           : Python
rfc              : RFC
ruby             : Ruby
wikipedia        : Wikipedia
yahoo            : Yahoo
yahoodict        : Yahoo dictionary
local            : Local HTML file

Open URL At New Tab:

input :W3mTab [url or keyword]

Open URL At Split Window:

input :W3mSplit [url or keyword]

Open URL At Vertical Split Window:

input :W3mVSplit [url or keyword]

Open Local Html File

input :W3m local html-file-path


input :W3mClose
input :bd

Copy URL To Clipboard:

input :W3mCopyUrl

Reload Current Page:

input :W3mReload

Change Url:

input :W3mAddressBar

Show External Browser:

input :W3mShowExtenalBrowser

Syntax Off:

input :W3mSyntaxOff

Syntax On:

input :W3mSyntaxOn

Change User-Agent

input :W3mSetUserAgent (w3m|Chrome|Firefox|IE6|IE7|IE8|IE9|Opera|Android|iOS|KDDI|DoCoMo|SoftBank)

Open from history:

input :W3mHistory

Clear history:

input :W3mHistoryClear



highlight! link w3mLink      Function
highlight! link w3mLinkHover SpecialKey
highlight! link w3mSubmit    Special
highlight! link w3mInput     String
highlight! link w3mBold      Comment
highlight! link w3mUnderline Underlined
highlight! link w3mHitAHint  Question
highlight! link w3mAnchor    Label

Use Proxy:

let &HTTP_PROXY=''

Set External Browser:

let g:w3m#external_browser = 'chrome'

Set Home Page:

let g:w3m#homepage = ""

Specify Key Of Hit-A-Hint:

let g:w3m#hit_a_hint_key = 'f'

Specify Default Search Engine:

let g:w3m#search_engine = 
    \ '' . &encoding . '&aq=&oq=&p='

Disable Default Keymap:

You set as follows if you do not want to use default keymap.

let g:w3m#disable_default_keymap = 1

Disable Vimproc:

You set as follows if you do not want to use vimproc.

let g:w3m#disable_vimproc = 1

Toggle Link Hovering

By default links under the curosr are highlighted. Turn off with one of the following

unlet g:w3m#set_hover_on
let g:w3m#hover_set_on = -1 
" a value less than or equal to 0 will turn it off

" set delay time until highlighting
let g:w3m#hover_delay_time = 100

Search Engine Localization:

Search engines are loaded from autoload/w3m/search_engines/YOUR_LOCALE/, and then from the "global" locale unless a localized search engine of the same name exists. Your locale defaults to v:lang, which vim sets based on your $LANG environment variable.

To specify a custom locale for loading search engines:

let g:w3m#lang = 'en_US'

Specify path to history file:

let g:w3m#history#save_file = $HOME.'/.vim_w3m_hist'

Default Keymaps

  • <CR> Open link under the cursor.
  • <S-CR> Open link under the cursor (with new tab).
  • <TAB> Move cursor next link.
  • <s-TAB> Move cursor previous link.
  • <Space> Scroll down.
  • <S-Space> Scroll up.
  • <BS> Back page.
  • <A-LEFT> Back page.
  • <A-RIGHT> Forward page.
  • = Show href under the cursor.
  • f Hit-A-Hint.
  • s Toggle Syntax On/Off.
  • c Toggle Cookie On/Off.
  • <M-D> Edit current url.


Sample Image1





v1.3.1 by yuratomo

  • #21 fix local href

v1.3.0 by yuratomo

  • Support select element.

v1.2.0 by yuratomo

  • Add search-engine for local html file.

v1.1.1 by yuratomo

  • Fix errors that occur during hover hilighting.

v1.1.0 by yuratomo

  • Hover links highlighting. (thanks dat5h)
  • Fixed default history file (thanks nise-nabe)
  • Fixed search_engine/rfc.vim

v1.0.0 by yuratomo

  • Add :W3mHistory
  • Add :W3mHistoryClear
  • Add syntax/w3m.vim
  • Add w3m#api#getHistoryList() function
  • Add w3m#api#openHistory() function

v0.8.3 by yuratomo

  • Fixed bug when w3m#EditAddress()
  • Add search-engine of vims (
  • Modify post logic

v0.8.2 by yuratomo

  • Add :W3mSplit
  • Add search-engine of 2ch
  • Should be buffer local commands.
  • Fixed bug when check box is pressed.
  • Debug and tool function move to another source.

v0.8.1 by yuratomo

  • modify search engine name. (java -> jdk)
  • modify msdn's page-filter logic.

v0.8.0 by yuratomo

  • Anchor Correspondence
  • add Anchor-Highlight (w3mAnchor)

v0.7.0 by yuratomo

  • Search by specifying search engine (#4)
  • Add page-filter function

v0.6.0 by yuratomo

  • add W3mSetUserAgent
  • add cookie settings.
  • w3m#option_use_cookie
  • w3m#option_accept_cookie
  • w3m#option_accept_bad_cookie
  • add w3m#ToggleSyntaxOnOff() (default key is 's')
  • add w3m#ToggleUseCookie() (default key is 'c')
  • add default keymap : nmap (w3m-address-bar)

v0.5.2 by yuratomo

  • bug fix 1 (nmap without )
  • bug fix 2 (can not execute hit-a-hint)

v0.5.1 by yuratomo

  • corresonds to vimproc
  • divided int plugin/w3m.vim and autoload/w3m.vim
  • Change the way the map.

v0.5.0 by yuratomo

  • neglect needless tag. (speed up analysis time)

v0.4.5 by yuratomo

  • add :W3mClose
  • add :W3mSyntaxOn / :W3mSyntaxOff
  • add g:w3m#hit_a_hint_key
  • Solution of the character code by &encoding
Something went wrong with that request. Please try again.