Piping buffer to external command in Vim

Question

I would like to send contents of the current buffer to stdin of external command (like mail).

How do I send a Vim buffer to an external command?

Related questions for providing selected text as `STDIN` to shell commands: [Pipe to shell and receive output on info line](http://stackoverflow.com/questions/2575545/vim-pipe-selected-text-to-shell-cmd-and-receive-output-on-vim-info-command-line) and [Replacing the selected original text with the output](http://stackoverflow.com/questions/6932382/replace-vim-selection-with-output-of-shell-command) — user1129682, Feb 17 '14 at 18:05

John Kugelman · Accepted Answer · 2021-03-24T06:28:02.877

You can use :w !cmd to write the current buffer to the stdin of an external command. From :help :w_c:

                                                        :w_c :write_c
:[range]w[rite] [++opt] !{cmd}
                        Execute {cmd} with [range] lines as standard input
                        (note the space in front of the '!').  {cmd} is
                        executed like with ":!{cmd}", any '!' is replaced with
                        the previous command :!.

A related command is :%!cmd which does the same thing and then replaces the current buffer with the output of the command. So :%!sort would invoke the external sort command to sort the current buffer in place. From :help :range!:

:{range}![!]{filter} [!][arg]                           :range!
                        Filter {range} lines through the external program
                        {filter}.  Vim replaces the optional bangs with the
                        latest given command and appends the optional [arg].
                        Vim saves the output of the filter command in a
                        temporary file and then reads the file into the buffer
                        tempfile.  Vim uses the 'shellredir' option to
                        redirect the filter output to the temporary file.
                        However, if the 'shelltemp' option is off then pipes
                        are used when possible (on Unix).
                        When the 'R' flag is included in 'cpoptions' marks in
                        the filtered lines are deleted, unless the
                        :keepmarks command is used.  Example: 
                                :keepmarks '<,'>!sort
                        When the number of lines after filtering is less than
                        before, marks in the missing lines are deleted anyway.

This is useful to format json like: `:'<,'>!python -mjson.tool` or `:%!python -mjson.tool` — TrinitronX, Nov 14 '13 at 23:14
For formatting go, use `:%!gofmt` without the last `%`, as that would cause it to use saved version (which may differ from current buffer) — thomasrutter, May 23 '17 at 00:36
Is there any way for this to replace the current buffer with the command output *only* on success? If the command returns non-zero, don't replace buffer? — thomasrutter, May 23 '17 at 00:37
@thomasrutter if the buffer is replaced with an error message instead of the intended output, you can just press `u` for undo — törzsmókus, Apr 08 '19 at 11:57
I have looked high and low for docs on `:%!my command` and have found *very* little. Where are the docs on this? — Russia Must Remove Putin, Mar 24 '21 at 02:44
@AaronHall I've added the help description to my answer. I don't blame you, it took me a good while to find it. — John Kugelman, Mar 24 '21 at 06:29

score 1 · Answer 2 · edited Apr 13 '17 at 12:51

1

Here is example how to send the current buffer to external stdin from the command line:

vim -es +"w >> /dev/stdout" -cq! /etc/hosts

It's useful for scripting purposes.

For more command-line tricks, check:

How to write whole buffer to standard output from the command line?

edited Apr 13 '17 at 12:51

Community

1
1

answered May 25 '15 at 21:13

kenorb

155,785
88
678
743

Piping buffer to external command in Vim

2 Answers2

Linked