diff --git a/vim_neovim_manpager.md b/vim_neovim_manpager.md
new file mode 100644
index 0000000..695a952
--- /dev/null
+++ b/vim_neovim_manpager.md
@@ -0,0 +1,61 @@
+# Vim or Neovim as a Manpager Replacement
+vim religion invades the manpages
+* tutorial video: [Link](https://www.youtube.com/watch?v=YjYgAn5li4g)
+
+### vim as manpager
+    vim ~/.bashrc or ~/.zshrc
+    export MANPAGER="/bin/sh -c \"col -b | vim --not-a-term -c 'set ft=man ts=8 nomod nolist noma' -\""
+    
+    # extra stuff in vimrc
+    vim ~/.vimrc
+    set cursorline                       " Highligt the cursor line
+    set cursorcolumn                     " Highlight the column line
+    set number                           " Show the line number
+
+### neovim as manpager with table of contents
+    nvim ~/.bashrc or ~/.zshrc
+    export MANPAGER="nvim +set\ filetype=man -"
+    
+    nvim ~/.config/nvim/init.vim
+    filetype plugin on
+    syntax on
+    
+    " manpage with table of contents sidebar with neovim
+    " https://asciinema.org/a/165076
+    " add to shellrc: export MANPAGER="nvim +set\ filetype=man -"
+    augroup manlaunchtoc
+        autocmd!
+        if has('nvim')
+            autocmd FileType man
+                \ call man#show_toc() |
+                \ setlocal laststatus=0 nonumber norelativenumber |
+                \ nnoremap <buffer> l <Enter> |
+                \ wincmd H |
+                \ vert resize 35 |
+                \ wincmd p
+        endif
+    augroup end
+
+### references
+- https://www.youtube.com/watch?v=YjYgAn5li4g
+- https://asciinema.org/a/165076
+- http://vim.wikia.com/wiki/Using_vim_as_a_man-page_viewer_under_Unix
+- https://zameermanji.com/blog/2012/12/30/using-vim-as-manpager/
+- https://vi.stackexchange.com/questions/4682/how-can-i-suppress-the-reading-from-stdin-message-from-within-vim
+
+### contact
+
+                 _   _     _      _         
+      __ _  ___ | |_| |__ | | ___| |_ _   _ 
+     / _` |/ _ \| __| '_ \| |/ _ \ __| | | |
+    | (_| | (_) | |_| |_) | |  __/ |_| |_| |
+     \__, |\___/ \__|_.__/|_|\___|\__|\__,_|
+     |___/                                  
+
+- http://www.youtube.com/user/gotbletu
+- https://twitter.com/gotbletu
+- https://plus.google.com/+gotbletu
+- https://github.com/gotbletu
+- gotbletu@gmail.com
+
+